GPT Image 2.6

SeedRouter の非同期画像 API を通じて、GPT Image 2.6 で画像の生成・編集、アニメーション GIF の作成、SVG 出力を行えます。

GPT Image 2.6 はテキストプロンプトと任意の参照画像を受け付けます。POST /v1/images/generations に一度送信してタスク ID を保存し、GET /v1/tasks/{id} をポーリングして結果を取得してください。完成したファイルは URL で返されます。

モデル ID と料金

GET /v1/models で、ご自身のキーで利用できるモデルを確認してください。設定済みの Sunburst ID は gpt-image-2.6-sunburst-official と gpt-image-2.6-sunburst です。Flare の ID が掲載されている場合も、同じパラメータ契約を使います。裸のモデル ID は Default グループを使い、追加グループはモデル一覧に表示される model:group ID を使います。

最新料金と Playground をご確認ください。トークン課金のモデルは実際の使用量で精算し、画像ごとに課金するモデルは設定された画像単価を使います。SVG のレスポンスではコード生成モデルのトークンが svg_usage に別途報告され、そのモデル独自の SeedRouter 単価で課金されます。

画像を生成する

curl https://api.seedrouter.ai/v1/images/generations \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.6-sunburst-official",
    "prompt": "A red paper crane on a pale blue table, soft daylight",
    "size": "1024x1024",
    "quality": "low",
    "complexity": "high"
  }'

レスポンスには id が含まれます。生成を再送信せず、その ID をポーリングしてください:

curl "https://api.seedrouter.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $SEEDROUTER_API_KEY"

完了すると、output.data に url を持つオブジェクトが含まれます。元のファイル形式と、GIF の場合はすべてのアニメーションフレームを保持するため、URL からダウンロードしてください。失敗したタスクには error があり、課金されません。タスクの状態とポーリングをご確認ください。

パラメータ

トップレベルのフィールドは 18 個です。必須は model と prompt のみです。任意のフィールドは null を受け付け、省略と同じ扱いになります。未知のフィールドは破棄されます。対応するフィールドに無効な値を指定すると、画像生成前の検証で拒否されます。

フィールド	型	デフォルトと制約
`model`	string	必須。ご自身のキーで利用できる ID を使ってください。
`prompt`	string	必須。空白のみは不可。最大 32,000 Unicode 文字。
`n`	integer	1。範囲は 1～10。SVG は 1 が必須。
`size`	string	`auto` または `WIDTHxHEIGHT`。下記のサイズ規則を参照。
`quality`	string	`auto`。ほかに `low`、`medium`、`high`、`xhigh`、`max`。
`background`	string	`auto`。ほかに `opaque`、`transparent`。JPEG は透過に非対応。
`output_format`	string	`png`。ほかに `jpeg`、`gif`、`svg`。WebP 出力は提供していません。
`output_compression`	integer	JPEG は 100。0～100。`output_format: "jpeg"` の場合のみ送信してください。
`moderation`	string	`auto`。ほかに `low`。公開 Playground では `low` は API のみで利用可能です。
`complexity`	string	`high`。ほかに `low`、`medium`。計画の度合いを設定し、別途追加料金はありません。
`frame_count`	integer	9。範囲は 2～16。GIF のみ。
`frame_duration_ms`	integer	200。20 ミリ秒以上で上限なし。GIF のみ。エンコーダーは最も近い 10 ms 単位に丸め、各フレームを最大 655,350 ms に制限します。
`svg`	object	省略。コード生成モデルの選択は任意。下記を参照。
`images`	array	`{"image_url":"https://..."}` 形式のオブジェクトを 1～16 個指定。編集に切り替わります。
`mask`	object	`{"image_url":"https://..."}`。`images` が必須。`markup` と併用不可。
`markup`	object	`{"image_url":"https://..."}`。`images` が必須。`mask` と併用不可。
`safety_identifier`	string	任意の固定エンドユーザー識別子。最大 128 文字。空でない値は `user` より優先されます。
`user`	string	非推奨の任意エンドユーザー識別子。Playground では表示も自動入力もされません。

参照 URL は HTTP または HTTPS を使い、認証情報を含めないでください。ファイル ID、インライン base64、multipart アップロードは受け付けません。先にファイルをアップロードし、公開 URL を指定してください。リクエストは stream や partial_images ではなく、非同期のタスクポーリングを使います。この契約では input_fidelity、response_format、prompt_rewriter は公開されていません。

画像サイズ

PNG、JPEG、SVG の参照画像生成では、各辺は 16 の倍数かつ 3840 ピクセル以下である必要があります。総ピクセル数は 655,360～8,294,400、アスペクト比は 1:3～3:1 の範囲です。例：1024x1024、1536x1024、2160x3840、2880x2880。

GIF の各辺は正の 16 の倍数にするか、auto を使ってください。GIF にはフレーム数、フレームサイズ、n に共通の独立した総ピクセル数の上限があります。OpenAI はその数値を公開していません。512x512 の GIF に静止画の最小ピクセル数の規則は適用されません。

アニメーション GIF

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A red paper crane flapping its wings in a seamless loop on pale blue",
  "output_format": "gif",
  "size": "512x512",
  "quality": "low",
  "frame_count": 4,
  "frame_duration_ms": 200
}

GIF はプロンプトから生成することも、参照画像から作成を依頼することもできます。マスクや圧縮と併用しないでください。プレビューの利用可否は選択したモデルへのアクセス権によって異なる場合があります。

文書間の相違、2026 年 11 月 5 日確認： OpenAI の画像生成ガイドは 2～64 フレーム、20～2000 ms と記載し、編集エンドポイントは GIF を返さないとしています。Images API リファレンスは 2～16 フレーム、表示時間に上限なしと記載し、編集での GIF 出力も挙げています。2026 年 11 月 5 日に送信したリクエストはリファレンスと一致し、17 フレームは拒否され、3,000 ms のフレームは受理されました。この API はリファレンスに従います。

SVG

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "A simple geometric red paper-crane logo, clean editable vector paths",
  "output_format": "svg",
  "n": 1
}

SVG は生成専用で、n: 1 が必須です。画像、マスク、描き込み、圧縮は送信しないでください。ファイルはベクター図形を含む静的な UTF-8 XML で、スクリプト、外部リソース、埋め込みラスター画像には対応していません。

コード生成モデルを選べる場合は svg: {"model":"YOUR_AUTHOR_MODEL_ID"} を追加してください。svg オブジェクトを明示的に指定する場合、空でない model が必須です。svg.reasoning.effort を none、minimal、low、medium、high、xhigh、max に設定することもできます。対応する値は選択したコード生成モデルによって決まります。デフォルトを使うには reasoning を省略してください。OpenAI はコード生成モデルの許可リストや共通のデフォルトを公開していません。モデルを選択できない場合は svg オブジェクト全体を省略してください。

完成した結果には、model、input_tokens、output_tokens、reasoning_tokens、total_tokens を持つ svg_usage が含まれる場合があります。これは画像の usage とは別で、画像トークン数への加算ではありません。

参照画像、マスク、描き込み

{
  "model": "gpt-image-2.6-sunburst-official",
  "prompt": "Replace the marked background with a pale blue studio backdrop",
  "images": [{"image_url":"https://example.com/reference.png"}],
  "markup": {"image_url":"https://example.com/transparent-markup.png"},
  "output_format": "png",
  "complexity": "low"
}

参照画像は PNG、JPEG、WebP に対応し、各ファイル最大 50 MB です。マスクと描き込みは PNG で、向きを適用した最初の参照画像と同じサイズにする必要があります。描き込みには透明なピクセルが必要です。描き込みと最初の参照画像は、それぞれ最大 16,777,216 ピクセル、描き込みは最大 50 MB です。マスクと描き込みは併用できません。

レスポンスフィールド

完了した画像出力には created、data: [{url}] と、報告される場合には size、quality、background、output_format、usage、svg_usage、safety_identifier が含まれます。usage はテキスト・画像の入力・出力トークンとキャッシュ済み入力に分かれる場合があります。公開出力には base64 の画像バイト列や費用フィールドは含まれません。

OpenAPI スキーマ · OpenAI 生成リファレンス · OpenAI 編集リファレンス · OpenAI 画像ガイド

On this page