API
Nano Banana 2 Lite API
画像Nano Banana 2 Lite API は、高速かつ効率的な画像生成に加え、安定したキャラクター一貫性、自然な複数画像の合成、自然言語による編集に対応します。日常のクリエイティブ制作に適した、軽量で高品質なビジュアル生成を Nano Banana 2 Lite API で実現できます。
ボディ
application/jsonmodelstring必須nano-banana-2-liteinput.promptstring必須作成したい画像、または参照画像に加えたい変更内容を記述します。前後の空白は除去されます。
最大長: 5,000 文字
input.imagesstring[]任意任意の参照画像 URL。一般公開されている HTTPS URL のみを使用してください。テキストから画像を生成する場合は省略できます。
最大項目数: 14
input.aspect_ratiostring任意出力の横幅と縦幅の比率。Auto を指定するとモデルが選択します。
デフォルト: auto
リクエスト例
POST /api/v1/createcurl -X POST https://nanobanana.io/api/v1/create \
-H "Authorization: Bearer sk_live_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"model": "nano-banana-2-lite",
"input": {
"prompt": "未来的なバナナ型カメラを写したシネマティックな商品写真"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-2-lite",
"status": "processing",
"credits": 18
}
}返されたタスク ID を使い、タスクが完了または失敗するまでこのエンドポイントをポーリングしてください。最新状態を確認するため、5 秒ごとのポーリングを推奨します。
POST /api/v1/check{
"task_id": "task_example"
}レスポンス
POST /api/v1/checkが返すタスクの状態です。以下のID、URL、タイムスタンプは例です。
idstring必須data.idはタスクの識別子で、状態確認リクエストのtask_idと一致します。
statusstring必須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": "nano-banana-2-lite",
"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": "nano-banana-2-lite",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}消費クレジット
1回のリクエストで画像を1枚生成する場合の消費クレジットです。
| 生成方式 | リクエストあたりのクレジット |
|---|---|
| 画像1枚 | 18 |
該当する料金を適用するには、表に記載されたinputパラメータを明示的に指定してください。複数の画像を生成するリクエストでは、消費クレジットが増える場合があります。
POST /api/v1/createのレスポンスに含まれるcreditsフィールドが、そのタスクで差し引かれたクレジット数を示します。