申請プロセス
Nano Banana Images API を使用するには、まず Ace Data Cloud コンソール で API トークンを取得し、保管してください。
まだログインまたは登録していない場合、自動的にログインページにリダイレクトされ、登録とログインを促されます。完了後、現在のページに自動的に戻ります。
1つの API トークンでプラットフォームのすべてのサービスを呼び出すことができ、各サービスごとに個別に申請する必要はありません。 初回申請時には無料のクレジットが付与され、無料で体験できます。クレジットが不足した場合は、コンソール で一般残高をチャージできます。
📘 完全なドキュメント：Nano Banana Images API →
インターフェース概要
- Base URL：
https://api.acedata.cloud - エンドポイント：
POST /nano-banana/images - 認証方式：HTTP ヘッダーに
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-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には成功した画像のみが含まれる。data[]：結果リスト。prompt：生成に使用されたプロンプト（エコー）。image_url：生成された画像の直接リンク URL。
注：/nano-banana/imagesではactionとpromptのみで画像を生成できます。
画像編集（action=edit）
既存の画像に基づいて編集したい場合、action を edit に設定し、image_urls で編集対象の画像リンクリスト（1枚または複数枚）を渡し、同時に編集目標を説明する prompt を提供します。
例えば、ここで人物の写真と服の写真を提供し、その人物にその服を着せる場合、画像リンクを同時に渡し、アクションを edit に指定します。URL は HTTP URL で、https または http プロトコルの公開アクセス可能なリンクである必要があります。また、Base64 エンコードされた画像（例：data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA+gAAAVGCAMAAAA6u2FyAAADAFBMVEXq6uwdHCEeHyMdHS....）も使用できます。
リクエスト例（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：認証失敗またはトークンが欠如。 - 429
too_many_requests：リクエスト頻度が超過。 - 500
api_error：サーバーエラー。
エラー応答例
パラメータ対照と注意事項
- 必須：
action、prompt - 編集専用：
image_urls（配列、少なくとも1項目） - オプション：
model（デフォルトはnano-banana、選択肢はnano-banana-2-lite、nano-banana-2、nano-banana-pro、または対応する:official公式チャネルバージョン）、aspect_ratio（アスペクト比、例：1:1、16:9）、resolution（解像度、例：1K、2K、4K；nano-banana-2-liteは1Kのみサポート）、callback_url（非同期コールバック用） - ヘッダー：
authorization: Bearer {token}を必ず提供；acceptはapplication/jsonに設定することを推奨 - 画像のアクセス性：
image_urlsは公開アクセス可能な直リンク（HTTP/HTTPS）である必要があり、HTTPSの使用を推奨 - 冪等性とトレース：
task_idとtrace_idを保持し、障害のトラブルシューティングと結果の関連付けを容易にします。