申請手順
Nano Banana Images API を使用するには、まず Ace Data Cloud コンソール で API Token を取得し、控えておいてください。
まだログインまたは登録していない場合は、登録とログインを促すログインページへ自動的に移動し、完了後に現在のページへ自動的に戻ります。
1 つの API Token でプラットフォームのすべてのサービスを呼び出すことができ、サービスごとに個別で申請する必要はありません。 初回申請時には無料枠が付与され、無料でお試しいただけます。枠が不足した場合は、コンソール で共通残高をチャージできます。
📘 完全なドキュメント:Nano Banana Images API →
インターフェース概要
- Base URL:
https://api.acedata.cloud - Endpoint:
POST /nano-banana/images - 認証方式:HTTP Header に
authorization: Bearer {token}を含める - リクエストヘッダー:
accept: application/jsoncontent-type: application/json
- アクション(action):
generate:テキストプロンプトに基づいて画像を生成edit:指定された画像に基づいて編集
- モデル(model)(任意):
nano-banana(デフォルト):Gemini 2.5 Flash Image ベース、高速かつ低コストnano-banana-2-lite:Gemini 3.1 Flash Lite Image ベース、1K のみ対応、生成速度が速いnano-banana-2:Gemini 3.1 Flash Image Preview ベース、Pro レベルの品質 + Flash の速度nano-banana-2.1:新世代の高効率画像モデル、1K、2K、4K の画像生成および編集に対応nano-banana-pro:Gemini 3 Pro Image Preview ベース、最高品質nano-banana:official、nano-banana-2-lite:official、nano-banana-2:official、nano-banana-pro:official:対応モデルの公式チャネル版であり、画質と安定性がより優れ、料金体系が異なります
- 非同期コールバック:任意。
callback_urlを通じてタスク完了通知と結果を受け取る - 画像数:任意。
countで 1~4 枚を指定、デフォルトは 1 枚。各画像は独立した生成呼び出しで完了します。通常の技術的失敗またはプロバイダーによる安全性拒否は該当する呼び出しにのみ影響し、その他の成功した画像は通常どおり返され、実際に成功した枚数に応じて課金されます
クイックスタート:画像生成(action=generate)
最小必須パラメータ:action、promptプロンプトに基づいて直接画像を生成したい場合は、
action を generate に設定し、明確な prompt を指定するだけです。
リクエスト例(cURL)
リクエスト例(Python)
成功レスポンス例
フィールド説明
success:今回のリクエストが成功したかどうか。task_id:タスク ID。trace_id:トレーシング ID。問題の調査に便利です。count:生成または編集をリクエストする画像数。1~4 に対応し、デフォルトは 1。dataには生成に成功した画像のみが含まれ、実際に返された枚数に応じて課金されます。各生成呼び出しでは、プロバイダーのネイティブ安全ポリシーが強制的に適用されます。ある呼び出しが拒否されても、他の成功した呼び出しには影響しません。すべての呼び出しが拒否された場合は 403 が返されます。data[]:結果リスト。prompt:生成に使用されたプロンプト(エコーバック)。image_url:生成画像の直接 URL。
注:/nano-banana/imagesはactionとpromptのみで画像を生成できます
画像を編集する(action=edit)
既存の画像に基づいて編集したい場合は、action を edit に設定し、image_urls を通じて編集対象の画像リンクリスト(1 枚または複数枚)を渡し、同時に編集目標を説明する prompt を指定します。
たとえば、ここでは人物写真 1 枚と服の写真 1 枚を提供し、その人物にその服を着せる場合、画像リンクを同時に渡し、action を edit に指定できます。URL は https または http プロトコルの公開アクセス可能な HTTP URL にすることも、data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA+gAAAVGCAMAAAA6u2FyAAADAFBMVEXq6uwdHCEeHyMdHS.... のような Base64 エンコード画像にすることもできます。
リクエスト例(cURL)
リクエスト例(Python)
成功レスポンス例
フィールド説明
image_urls[]:編集対象画像の URL リスト(パブリックネットワークからアクセス可能である必要があります)。複数枚渡すことができ、サービスはこれらの素材とpromptを組み合わせて編集を完了します。- その他のフィールドは「画像生成」のレスポンスと同じです。
非同期コールバック(任意、推奨)
生成または編集には一定の時間がかかる場合があります。長時間接続によるリソース占有を避けるため、callback_url を通じて Webhook コールバックを使用することを推奨します。
- リクエストボディに
callback_urlを追加します。たとえば、サーバー側の Webhook アドレスです(パブリックネットワークからアクセス可能で、POST JSON をサポートする必要があります)。 - API は
task_idを含むレスポンス(または基本結果を含むレスポンス)を即座に返します。 - タスク完了後、プラットフォームは
POST方式で完全な JSON をcallback_urlに送信します。task_idを通じてリクエストと結果を関連付けることができます。
エラー処理
呼び出しに失敗した場合、標準のエラー形式とトレース ID が返されます。一般的なエラーは以下のとおりです。- 400
token_mismatched:リクエストが不正、またはパラメータエラーです。 - 400
api_not_implemented:インターフェースが実装されていません(サポートにお問い合わせください)。 - 401
invalid_token:認証に失敗した、または Token がありません。 - 403
forbidden:プロバイダーのネイティブセキュリティポリシーにより、リクエストまたは生成結果が拒否されました。この呼び出しでは画像は返されず、課金もされません。複数画像のリクエストでは、他の成功した呼び出しは引き続き返され、課金される場合があります。 - 429
too_many_requests:リクエスト頻度が上限を超えています。 - 500
api_error:サーバー側の例外です。
エラーレスポンス例
パラメータ対応表と注意事項
- 必須:
action、prompt - 編集専用:
image_urls(配列、少なくとも 1 項目) - 任意:
model(デフォルトはnano-banana、nano-banana-2-lite、nano-banana-2、nano-banana-2.1、nano-banana-proを選択可能。nano-banana-2.1以外には対応する:official公式チャネルバージョンもあります)、aspect_ratio(アスペクト比、例:1:1、16:9)、resolution(解像度、例:1K、2K、4K。nano-banana-2-liteは1Kのみサポート)、callback_url(非同期コールバック用) - Headers:
authorization: Bearer {token}を必ず指定する必要があります。acceptはapplication/jsonに設定することを推奨します - 画像のアクセス可能性:
image_urlsはパブリックネットワークからアクセス可能な直接リンク(HTTP/HTTPS)である必要があります。HTTPS の使用を推奨します - 冪等性と追跡:障害調査および結果の関連付けを容易にするため、
task_idとtrace_idを保持してください

