API
Nano Banana Pro API
画像Nano Banana Pro API は、高品質な 2K 画像生成と 4K アップスケールに対応し、より優れたプロンプト理解、正確な文字描画、洗練されたライティング、構図制御を提供します。API を統合することで、より精密で本番運用に適した画像生成をアプリケーションに組み込めます。
ボディ
application/jsonmodelstring必須nano-banana-proinput.promptstring必須作成したい画像、または参照画像に加えたい変更内容を記述します。前後の空白は除去されます。
最大長: 5,000 文字
input.imagesstring[]任意任意の参照画像 URL。一般公開されている HTTPS URL のみを使用してください。テキストから画像を生成する場合は省略できます。
最大項目数: 14
input.aspect_ratiostring任意出力の横幅と縦幅の比率。Auto を指定するとモデルが選択します。
デフォルト: auto
input.resolutionstring任意出力解像度のレベル。値は大文字・小文字を区別しません。省略または空欄の場合はデフォルト値を使用します。
デフォルト: 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-pro",
"input": {
"prompt": "未来的なバナナ型カメラを写したシネマティックな商品写真"
}
}'POST /api/v1/create · HTTP 201{
"data": {
"task_id": "task_example",
"model": "nano-banana-pro",
"status": "processing",
"credits": 50
}
}返されたタスク 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-pro",
"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-pro",
"status": "failed",
"data": null,
"failed_reason": "Generation failed."
}
}消費クレジット
1回のリクエストで画像を1枚生成する場合の消費クレジットです。
| 解像度 | 1K | 2K | 4K |
|---|---|---|---|
| 画像1枚 | 30 | 30 | 50 |
任意のパラメータを省略: 50 クレジット
該当する料金を適用するには、表に記載されたinputパラメータを明示的に指定してください。複数の画像を生成するリクエストでは、消費クレジットが増える場合があります。
POST /api/v1/createのレスポンスに含まれるcreditsフィールドが、そのタスクで差し引かれたクレジット数を示します。