Nano Banana ロゴNano Banana
API の概要クイックスタート

API

GPT Image 2.5 API

画像

GPT Image 2.5 APIは、OpenAIの最先端の画像生成・編集モデルをアプリに導入します。テキストからの画像生成や参照画像の編集に対応し、柔軟なアスペクト比と1K、2K、4K出力を利用できます。日常的な高品質画像をすばやく生成するにはflare、品質要件の厳しい制作や精密な画像編集にはsunburstを選択してください。

認証

Bearerstringheader必須

リクエスト認証用 API キー

ボディ

application/json
modelstring必須
gpt-image-2-5
input.promptstring必須

生成したい画像の被写体、構図、スタイル、照明を説明してください。画像を編集する場合は、参照画像のどの部分を変更し、どの部分を維持するかを指定してください。先頭と末尾の空白は削除されます。

input.modestring任意

GPT Image 2.5のモデルを選択します。flareはデフォルトで、日常的な高品質画像の生成や素早い試行を重視します。sunburstは高い品質要件と編集精度を重視し、参照画像を正確に変更したい場合に適しています。

両モードともテキストからの画像生成と画像編集に対応しています。テキストから生成する場合はinput.imagesを省略し、編集する場合は参照画像を指定してください。比較時はプロンプト、参照画像、アスペクト比、解像度を同じにしてください。

デフォルト: flare

flaresunburst
input.imagesstring[]任意

任意の参照画像 URL。一般公開されている HTTPS URL のみを使用してください。テキストから画像を生成する場合は省略できます。

input.aspect_ratiostring任意

出力画像の幅と高さの比率です。autoではモデルが適切な構図を選択します。一覧の比率を指定すると形式を制御できます。例：正方形は1:1、縦長は9:16、横長は16:9。

デフォルト: auto

auto1:12:33:23:44:39:1616:921:9
input.resolutionstring任意

出力解像度の段階です。小文字の1k、2k、4kから選択してください。特定の解像度が必要な場合は、この項目を明示的に指定してください。

デフォルト: 2k

1k2k4k

リクエスト例

POST /api/v1/create
curl -X POST https://nanobanana.io/api/v1/create \
  -H "Authorization: Bearer sk_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "gpt-image-2-5",
  "input": {
    "prompt": "未来的なバナナ型カメラを写したシネマティックな商品写真"
  }
}'
POST /api/v1/create · HTTP 201
{
  "data": {
    "task_id": "task_example",
    "model": "gpt-image-2-5",
    "status": "processing",
    "credits": 5
  }
}

返されたタスク ID を使い、タスクが完了または失敗するまでこのエンドポイントをポーリングしてください。最新状態を確認するため、5 秒ごとのポーリングを推奨します。

POST /api/v1/check
{
  "task_id": "task_example"
}

レスポンス

POST /api/v1/checkが返すタスクの状態です。以下のID、URL、タイムスタンプは例です。

idstring必須

data.idはタスクの識別子で、状態確認リクエストのtask_idと一致します。

statusstring必須
completedは生成の成功を示し、data.dataに結果が含まれます。その他の状態ではdata.dataはnullです。
failed_reasonstring任意

statusがfailedの場合にのみ返され、失敗の理由を示します。completedとprocessingではこの項目は含まれません。

完了 · completed

ダウンロードURLはdata.data.resultsにあります。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "completed",
    "data": {
      "results": [
        "https://example.com/generated.png"
      ],
      "processing_time": 18
    }
  }
}

その他の状態

processingまたはfailedではdata.dataはnullです。以下はfailedの例です。failed_reasonはfailedの場合にのみ含まれます。processingでは状態確認を続け、failedでは停止してください。

POST /api/v1/check · HTTP 200
{
  "data": {
    "id": "task_example",
    "created_at": 1791244800,
    "model": "gpt-image-2-5",
    "status": "failed",
    "data": null,
    "failed_reason": "Generation failed."
  }
}

消費クレジット

1回のリクエストで画像を1枚生成する場合の消費クレジットです。

1回のリクエストで画像を1枚生成する場合の消費クレジットです。
解像度1K2K4K
画像1枚123650

任意のパラメータを省略: 5 クレジット

該当する料金を適用するには、表に記載されたinputパラメータを明示的に指定してください。複数の画像を生成するリクエストでは、消費クレジットが増える場合があります。

POST /api/v1/createのレスポンスに含まれるcreditsフィールドが、そのタスクで差し引かれたクレジット数を示します。