API
Nano Banana 2.1 API
画像Nano Banana 2.1 API は、より鮮明な画像生成と精密な編集を実現します。テキストプロンプトから画像を生成したり、参照画像を編集したりでき、柔軟なアスペクト比と最大 4K の出力に対応しています。API を組み込むことで、アプリに高品質な画像生成・編集機能を追加できます。
ボディ
application/jsonmodelstring必須nano-banana-2-1input.promptstring必須作成したい画像、または参照画像に加えたい変更内容を記述します。前後の空白は除去されます。
input.imagesstring[]任意任意の参照画像 URL。一般公開されている HTTPS URL のみを使用してください。テキストから画像を生成する場合は省略できます。
input.aspect_ratiostring任意出力の横幅と縦幅の比率。Auto を指定するとモデルが選択します。
デフォルト: auto
input.resolutionstring任意出力画像の解像度。小文字の 1k、2k、4k を指定してください。省略または空の場合は、デフォルトの 2k が使用されます。
デフォルト: 2k
リクエスト例
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-1",
"input": {
"prompt": "未来的なバナナ型カメラを写したシネマティックな商品写真",
"aspect_ratio": "1:1",
"resolution": "2k"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-2-1",
"status": "processing",
"credits": 20
}
}返されたタスク 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-1",
"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-1",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}消費クレジット
1回のリクエストで画像を1枚生成する場合の消費クレジットです。
| 解像度 | 1K | 2K | 4K |
|---|---|---|---|
| 画像1枚 | 12 | 20 | 30 |
任意のパラメータを省略: 12 クレジット
該当する料金を適用するには、表に記載されたinputパラメータを明示的に指定してください。複数の画像を生成するリクエストでは、消費クレジットが増える場合があります。
POST /api/v1/createのレスポンスに含まれるcreditsフィールドが、そのタスクで差し引かれたクレジット数を示します。