画像モデル上級者向け更新日
POST/v1/images/generations

API コンソール

POST/v1/images/generations
キーを確認

入力したキーで実際にリクエストを送信し、API の通常料金が適用されます。

GPT Image 2.6 Sunburst

リクエスト ID gpt-image-2.6-sunburst

プロトコル

認証

リクエストには API キー管理 の API キーが必要です。JSON リクエストには Content-Type: application/json を設定します。

  • Authorization: Bearer YOUR_API_KEY

リクエストパラメータ

POST /v1/images/generations

項目型必須説明
modelstring必須このモデル ID を指定します gpt-image-2.6-sunburst.
promptstring必須生成したい画像を説明します。
sizestring条件付きGIF では auto を指定します。静止画では aspect_ratio と image_size を使います。
aspect_ratiostring条件付き出力画像のアスペクト比です。 指定可能な値 auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. 既定値 auto. 静止画用です。GIF では省略します。
image_sizestring条件付き出力解像度の設定です。 指定可能な値 1K, 2K, 4K. 省略時は size から算出します。 既定値 1K. 静止画用です。GIF では省略します。
resolutionstring条件付き静止画の解像度の別名です。image_size と同時に指定する場合は同じ値にします。 静止画用です。GIF では省略します。
output_formatstring任意png は静止画、gif はアニメーションです。GIF では size: "auto" と n: 1 を指定します。フレームは自動設定されます。 既定値 png.
backgroundstring任意背景は自動設定です。 指定可能な値 auto.
qualitystring任意生成品質の設定です。 指定可能な値 auto, low, medium, high. 既定値 auto.
ninteger任意1 リクエストにつき 1 枚生成します。 既定値 1.
image_urlsstring[]任意参照画像の JSON 配列です。公開 HTTPS 画像 URL または Base64 画像のデータ URL を指定します。 互換フィールド image_input. 参照画像の上限 8. 2K または 4K の静止画には PNG、JPEG、WebP の参照画像を使います。
?asyncstring任意URL のクエリパラメータです。1、true、yes で 202 と task_id を返します。省略時は結果を待ちます。

POST /v1/images/edits

項目型必須説明
modelstring必須このモデル ID を指定します gpt-image-2.6-sunburst.
promptstring必須参照画像に加える変更を説明します。
aspect_ratiostring任意出力画像のアスペクト比です。 指定可能な値 auto, 1:1, 3:2, 2:3, 16:9, 9:16, 4:3, 3:4, 4:5, 5:4. 既定値 auto.
image_sizestring任意出力解像度の設定です。 指定可能な値 1K, 2K, 4K. 省略時は size から算出します。 既定値 1K.
resolutionstring任意静止画の解像度の別名です。image_size と同時に指定する場合は同じ値にします。
output_formatstring任意編集結果は PNG 形式です。 既定値 png.
backgroundstring任意背景は自動設定です。 指定可能な値 auto.
qualitystring任意生成品質の設定です。 指定可能な値 auto, low, medium, high. 既定値 auto.
ninteger任意1 リクエストにつき 1 枚生成します。 既定値 1.
image_urlsstring[]条件付き参照画像の JSON 配列です。公開 HTTPS 画像 URL または Base64 画像のデータ URL を指定します。 互換フィールド image_input. 参照画像の上限 8. JSON で編集する場合は 1 枚以上を指定します。 2K または 4K の静止画には PNG、JPEG、WebP の参照画像を使います。
image[]file[]条件付きmultipart/form-data で編集する場合は 1 枚以上をアップロードし、複数枚は同じフィールドを繰り返します。1 ファイルなら image も使えます。 参照画像の上限 8. 2K または 4K の静止画には PNG、JPEG、WebP の参照画像を使います。
?asyncstring任意URL のクエリパラメータです。1、true、yes で 202 と task_id を返します。省略時は結果を待ちます。

リクエスト例

API Key をローカルの環境変数 ICODEEASY_API_KEY に設定し、直接 HTTP 呼び出しに対応するエンドポイントを選択します。指定クライアントが必要な場合は設定ガイドに従ってください。

例のメディア URL とアセット ID は、有効な素材に置き換えてください。

Images Generations

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A watercolor illustration of a paper lantern by a lake.",
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

Images Generations · GIF を生成

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "A paper lantern sways gently in a seamless loop.",
  "output_format": "gif",
  "size": "auto",
  "n": 1
}'

Images Generations · 参照画像から GIF を生成

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/generations?async=1' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "Animate the lantern in the reference image in a seamless loop while preserving the composition.",
  "output_format": "gif",
  "size": "auto",
  "n": 1,
  "image_urls": [
    "https://example.com/reference.png"
  ]
}'

Images Edits

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/edits' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{
  "model": "gpt-image-2.6-sunburst",
  "prompt": "Change the background to a pale blue wall. Preserve the subject.",
  "image_urls": [
    "https://example.com/reference.png"
  ],
  "output_format": "png",
  "aspect_ratio": "16:9",
  "image_size": "1K",
  "n": 1
}'

画像タスクを照会

bash
curl -sS 'https://api.icodeeasy.cc/v1/images/tasks/YOUR_TASK_ID' \
  -H "Authorization: Bearer $ICODEEASY_API_KEY"

レスポンスとタスク

HTTP 200 · 同期リクエストの成功

?sync=1 を指定した場合、画像 URL は data[].url から取得できます。created は UNIX 秒、id はタスク ID です。

json
{
  "id": "d142c93a-de26-40c9-be62-0de840d10960",
  "created": 1781599773,
  "data": [
    {
      "url": "https://example.com/generated-image.png"
    }
  ]
}

HTTP 202 · 非同期リクエストの受付

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "pending"
}

?async=1 を指定した場合は、同じ API キーで GET /v1/images/tasks/{task_id} をポーリングします。status は pending、completed、failed のいずれかです。完了後は result_url から画像 URL を取得できます。

HTTP 200 · 完了したタスクの取得

json
{
  "task_id": "d142c93a-de26-40c9-be62-0de840d10960",
  "status": "completed",
  "model": "gpt-image-2.6-sunburst",
  "result_url": "https://example.com/generated-image.png"
}

主なエラー

照会結果が failed の場合は error を確認してください。error_detail がある場合は再送前に retryable を確認します。

レスポンス例とエラー

接続ガイド · リクエスト項目、タスクの状態、レスポンス形式は API ガイドを参照してください。

機能と制限

  • text_to_image · 対応
  • image_to_image · 対応
  • image_editing · 対応
  • reference_images · 条件付き対応 — 対応するリクエスト形式で有効な参照画像が必要です
  • 制限 参照画像：最大 8 枚 · 解像度: 1K, 2K, 4K · 入力：Static PNG or animated GIF. GIF uses size: auto and n: 1. Static 2K/4K reference images must be PNG, JPEG, or WebP.

モデル機能カタログ · 価格を確認

関連ガイド

画像生成 API

OpenAI 互換 API で画像を生成・編集します。プロンプト、サイズ、参照画像を指定し、同期結果や非同期ジョブの状態を確認します。

モデル機能カタログ

公開されているテキスト・画像・動画モデルについて、正規化されたリクエスト ID、互換プロトコル、対応クライアント、ツール利用、入出力機能、制限、確認日を比較できます。

登録して API Key を取得