画像 API

概要

画像 API は タスク方式 で生成リクエストを送ります：すべてのモデルが同一の送信エンドポイント POST /api/generate/submit を共有し、違いは model フィールドと input.metadata のモデル固有パラメータのみです。送信すると即座に task_id が返るので、GET /api/generate/status/{task_id} を status=finished までポーリングしてください。

認証

AI API と同じ Bearer トークン：Authorization: Bearer sk-xxxxxx。

共通リクエスト構造

{
  "model": "gpt-image-2 | nano-banana-2 | nano-banana-pro",
  "input": {
    "prompt": "画像の説明",
    "size": "1:1 | 16:9 | 9:16 | auto | 1024x1024",
    "image": "参照画像 URL（任意）",
    "images": ["参照画像 URL リスト（任意）"],
    "metadata": { /* モデル固有パラメータ */ }
  }
}

input の直下に置けるのは prompt / size / image / images / duration / seconds のみ。それ以外のフィールド（quality、resolution、n、mask_url など）は input.metadata に入れる必要があります。直下に置くと 400 が返ります。

概要

共通リクエスト構造

モデル

gpt-image-2

nano-banana-2

nano-banana-pro

目次