Image API

画像の生成と編集

単一のリクエスト形式でGPT Image 2, GPT Image 2.5 Flare, GPT Image 2.5 Sunburst, Nano Banana, Nano Banana 2, Nano Banana 2 Lite, Nano Banana 2.1, Nano Banana Pro, Seedream 4.0, Seedream 4.5, Seedream 5.0, Seedream 5 Proを実行できます。

エンドポイント

プロンプトから画像を生成するには /v1/images/generations を使用します。JSON を受け付けます。

POSThttps://api.mlmux.com/v1/images/generations

画像の編集や合成には /v1/images/edits を使用します。JSON で画像 URL を送信するか、multipart フィールドの image および mask でファイルをアップロードします。最大 16 枚（各 50 MB まで）を受け付けます。

POSThttps://api.mlmux.com/v1/images/edits

リクエスト例

curl https://api.mlmux.com/v1/images/generations \
  -H "Authorization: Bearer $MLMUX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "nano-banana-2",
  "prompt": "Editorial product photo of a ceramic mug on linen, soft window light",
  "aspect_ratio": "4:3",
  "resolution": "2K",
  "output_format": "png",
  "route_mode": "official-cheap"
}'

リクエストはデフォルトで同期処理され、レスポンス内に画像が返されます。代わりにタスクを受け取るには "async": true を追加してください。

パラメーター

フィールド	型	必須	説明
`model`	string	はい	以下の表にあるモデル ID。短縮名が一意である場合、`gpt-image-2` のようにプロバイダー接頭辞を省略できます。
`prompt`	string	はい	生成または変更する内容（最大 20,000 文字）。
`image_urls`編集のみ	string[]	はい	入力画像の公開 http(s) URL（順序指定）。単一画像の場合は `image_url` も指定可能です。
`mask_url`編集のみ	string	いいえ	マスク編集をサポートするモデル向けのマスク画像 URL。
`route_mode`	string	いいえ	`official` または `official-cheap`。デフォルトはキーのルーティングモード、次いで `official-cheap` です。
`resolution`	string	いいえ	対応する Gemini モデルでは `1K`、`2K`、または `4K`。Nano Banana および Nano Banana 2 Lite には解像度設定がありません。
`size`	string	いいえ	GPT Image および Seedream の出力サイズ（例: `1024x1024`、`2K`、`auto`）。
`aspect_ratio`	string	いいえ	`1:1`、`16:9`、`match_input_image` など。指定可能な値はモデルによって異なります。
`output_format`	string	いいえ	モデルがサポートしている場合、`png`、`jpg`、`jpeg`、または `webp`。
`n`	integer	いいえ	画像数（1〜4）。デフォルトは 1 です。
`async`	boolean	いいえ	`true` を指定すると、画像の完了を待つ代わりにポーリング用のタスク（HTTP 202）を返します。

モデル ID

model にこれらの値を指定します。GET /v1/models でアカウントで利用可能な ID を取得できます。

モデル	モデルID
GPT Image 2	`openai/gpt-image-2`
GPT Image 2.5 Flare	`weavy/gpt-image-2.5-flare`
GPT Image 2.5 Sunburst	`weavy/gpt-image-2.5-sunburst`
Nano Banana	`nano-banana`
Nano Banana 2	`nano-banana-2`
Nano Banana 2 Lite	`nano-banana-2-lite`
Nano Banana 2.1	`google/gemini-nano-banana-2.1`
Nano Banana Pro	`nano-banana-pro`
Seedream 4.0	`weavy/doubao-seedream-4-0-250828`
Seedream 4.5	`weavy/doubao-seedream-4-5-251128`
Seedream 5.0	`weavy/doubao-seedream-5-0-260128`
Seedream 5 Pro	`weavy/doubao-seedream-5-0-pro-260628`

GPT Image 2、GPT Image 2.5 Flare、GPT Image 2.5 Sunburst は現在 official でのみ動作します。これらのモデルでは "route_mode": "official" を送信してください。指定しない場合、リクエストはデフォルトの official-cheap を使用して失敗します。

レスポンス

同期リクエストは HTTP 200 を返し、data に画像ごとの URL、usage にトークン数が含まれます。出力 URL は MLMux でホストされるため、保持したいファイルはダウンロードしてください。

200 OK

{
  "created": 1767225600,
  "data": [
    { "url": "https://.../generated/9f2c....png" }
  ],
  "usage": {
    "input_tokens": 18,
    "output_tokens": 1120,
    "total_tokens": 1138,
    "input_tokens_details": { "text_tokens": 18, "image_tokens": 0 }
  }
}

非同期リクエスト

"async": true を指定すると、リクエストは HTTP 202 とタスクを返します。status が succeeded になるまで poll_url をポーリングします。完了すると data に画像が一覧表示されます。

GEThttps://api.mlmux.com/v1/images/generations/{task_id}

202 Accepted

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "queued",
  "created": 1767225600,
  "model": "nano-banana-2",
  "api_method": "images.generations.create",
  "poll_url": "/v1/images/generations/task_7c1e...",
  "progress": 0,
  "message": "queued",
  "estimated_charge_credits": 0.067
}

成功

{
  "id": "task_7c1e...",
  "object": "image.generation.task",
  "status": "succeeded",
  "progress": 100,
  "message": "completed",
  "estimated_charge_credits": 0.067,
  "data": [
    { "url": "https://.../generated/7c1e....png" }
  ]
}

画像編集タスクは /v1/images/edits/{task_id} でポーリングします。GET /v1/tasks/{task_id} はすべてのタスクで使用できます。