GPT-Image-2 画像生成

• モデル: gpt-image-2
• エンドポイント: POST https://apimaster.ai/v1/images/generations
• モード: 非同期 — task_id を返し、その後タスクをポーリングします。
• 機能: テキストから画像への生成、最大16枚の参照画像（URL + base64 混合）を用いた画像から画像への生成。

認証

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

ボディパラメータ

フィールド	型	必須	備考
model	string	はい	gpt-image-2
prompt	string	はい	シーンの説明。安全モデレーションが適用されます。
n	integer	いいえ	1 のみ（数値、引用符なし）
size	string	いいえ	アスペクト比、デフォルト 1:1
resolution	string	いいえ	1k / 2k / 4k、デフォルト 1k
image_urls	array	いいえ	参照画像 → 画像から画像への変換
official_fallback	boolean	いいえ	公式チャネルへのフォールバック、デフォルト false

size の値

auto、1:1、3:2、2:3、4:3、3:4、5:4、4:5、16:9、9:16、2:1、1:2、3:1、1:3、21:9、9:21、または 3840x2160 のようなピクセル文字列。

解像度（サンプルピクセル）

size	1k	2k	4k
1:1	1024×1024	2048×2048	2880×2880
16:9	1536×864	2048×1152	3840×2160

全15のアスペクト比で4Kに対応しています。

image_urls

• 最大 16 枚の画像
• 公開 URL と base64 data URI を混在可能
• size を省略すると入力解像度に従い、size を指定すると出力のアスペクト比を強制します。

例

最小限のテキストから画像への生成

{
  "model": "gpt-image-2",
  "prompt": "An orange cat on a windowsill at sunset, watercolor"
}

16:9 @ 2K

curl -s "https://apimaster.ai/v1/images/generations" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a corgi astronaut on the moon, cinematic",
    "size": "16:9",
    "resolution": "2k"
  }'

送信応答

{
  "code": 200,
  "data": [{ "status": "submitted", "task_id": "task_01KPQ7J7DWB7QZ3WCEK3YVPBRA" }]
}

HTTP	意味
400	無効なパラメータ
401	不正な API キー
402	残高不足
429	レート制限

タスク結果のポーリング

curl -s "https://apimaster.ai/v1/tasks/TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

画像 URL: data.result.images[0].url[0]

status	意味
submitted	キューイング済み
processing	実行中
completed	完了
failed	エラーを参照

10～20秒後から、3～5秒ごとにポーリングします。バッチ: POST https://apimaster.ai/v1/tasks/batch で {"task_ids":[...]} を使用します。

注意事項

• 非同期のみ — 作成応答に同期的な画像 URL は含まれません。
• アスペクト比は size を使用することを推奨します。prompt 内で比率を繰り返さないでください。
• 課金は解像度階層に基づきます。アカウントのコンソールを参照してください。

公式チャネルと比較してください。