Nano Banana 2 API
GoEnhance の独立した API を通じて、Nano Banana 2 でテキストから画像を生成します。対応するアスペクト比と 0.5K–4K の出力サイズを選び、ポーリングまたはコールバックで結果を受け取ります。GoEnhance は Google ではなく、このエンドポイントは Google 公式の Gemini API でもありません。
API キーを作成
柔軟なテキストからの画像生成
プロンプトと出力の制御
model に nano-banana-2 を指定し、1–2000 文字のプロンプトを送信します。ドキュメント記載のアスペクト比、出力サイズ、任意の推論の深さを選択できます。
非同期でのタスク受け取り
送信に成功すると img_uuid が返ります。GET /api/v1/jobs/detail をポーリングするか、公開アクセス可能な HTTPS のコールバック URL を指定してステータス更新を受け取ります。
生成タスクを送信する前に、正確なモデル ID とドキュメント記載のフィールドをご確認ください。
Nano Banana 2 API のパラメータ
モデル
必須。<code>model</code> には <code>nano-banana-2</code> を正確に指定します。
プロンプト
必須のテキスト説明で、1 文字から 2000 文字までです。
アスペクト比
任意の <code>ratio</code>。対応する値は auto、1:1、16:9、9:16、4:3、3:4、2:3、3:2、4:5、5:4、21:9、1:4、4:1、1:8、8:1 です。
画像サイズ
任意の <code>image_size</code> の既定値は <code>1k</code> です。指定できる値は <code>0.5k</code>、<code>1k</code>、<code>2k</code>、<code>4k</code> です。
生成のコントロール
任意のコントロールには <code>web_search</code> と、大文字小文字を区別する <code>thinking_level</code> の値 <code>High</code> または <code>Minimal</code> があります。
認証とコールバック
<code>Authorization</code> ヘッダーを送信してください。任意の <code>custom_callback_url</code> は、公開アクセス可能な HTTPS の URL である必要があります。
料金は生成された画像ごとに発生し、リクエストした出力サイズによって変わります。
Nano Banana 2 API の料金とタスクの挙動
0.5K と 1K の料金
0.5K は画像 1 枚あたり 3 トークン（$0.060）です。1K は画像 1 枚あたり 3.3 トークン（$0.066）です。
2K と 4K の料金
2K は画像 1 枚あたり 5 トークン（$0.100）です。4K は画像 1 枚あたり 7.5 トークン（$0.150）です。
非同期での結果取得
送信時に返るのは <code>img_uuid</code> であり、最終的な画像ではありません。タスク詳細のエンドポイントをポーリングするか、コールバックイベントを処理して最終結果を取得してください。
3 ステップで導入する Nano Banana 2
1
1. 生成リクエストの送信
https://api.goenhance.ai/api/v1/images/generations に JSON を POST し、認証情報、model、prompt、および任意のアスペクト比、サイズ、ウェブ検索、推論、コールバックの各フィールドを指定します。 2
2. img_uuid の保存
成功レスポンスから
data.img_uuid を読み取り、アプリケーション側のリクエストと紐付けます。 3
3. ポーリングまたはコールバックの受信
GET /api/v1/jobs/detail をポーリングするか、コールバックイベントを処理します。エンドポイントが HTTP 200 を返さない場合、GoEnhance のドキュメントではコールバックを最大 3 回まで再試行し、1 回あたりのタイムアウトは 3 秒と記載されています。プロンプト、レビュー、保存、配信はアプリケーション側で管理しながら、制御された画像生成ワークフローを構築します。
Nano Banana 2 API のユースケース
エディトリアルイラスト
構造化された記事の要件を、人によるレビュー用のビジュアル候補に変換します。
プロダクトストーリーテリング
商品説明からシーンのコンセプトを生成し、後段のブランドおよびコンプライアンス確認に回します。
キャンペーンのバリエーション
プロンプトとアスペクト比のバリエーションを作成し、各非同期タスクを個別に追跡します。
ローカライズのワークフロー
タスク処理の構成を変えることなく、ローカライズされたプロンプトから地域向けのビジュアル案を作成します。
コンセプト開発
本番用アセットを確定する前に、キャラクター、小道具、環境、アートディレクションを検討します。
自動化されたクリエイティブパイプライン
コールバックをモデレーション、承認、ストレージ、下流のアセット処理サービスに接続します。
料金、パラメータ、非同期での受け取り、Google API との関係についての実践的な回答です。