申請プロセス
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には生成に成功した画像のみが含まれ、実際の返却枚数に基づいて課金される。各生成呼び出しは提供者の原生安全ポリシーを強制的に使用；特定の呼び出しが拒否されても他の成功した呼び出しには影響し、すべての呼び出しが拒否された場合は 403 が返される。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：認証失敗またはトークンが欠如。 - 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-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を保持し、障害調査と結果の関連付けを容易にします。