Nano Banana 2 から 2.1 への移行：API で変更すべき点

Nano Banana 2.1 は引き続き HiAPI の非同期タスクインターフェースを使用するため、コードの移行量は多くありませんが、いくつかの入力制約を再確認する必要があります。最も明確な変化は model の値で、参照画像の枚数と 1 枚あたりのファイルサイズも変更されています。価格は公開前のリアルタイムページとタスク記録を基準にしてください。

本記事は Nano Banana 2 モデルページ と Nano Banana 2.1 モデルページ で現在表示されているインターフェース契約に基づいて整理しています。例は現在のドキュメントにあるリクエスト構造を採用しており、本番トラフィックを切り替える前に残高のあるテストアカウントで検証してください。

最小限の変更は model の置き換え

両バージョンとも非同期タスクで作成します：

curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gemini-nano-banana-2.1",
    "input": {
      "prompt": "A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering",
      "resolution": "1K",
      "aspect_ratio": "1:1",
      "output_format": "png"
    }
  }'

元のリクエストがテキストからの画像生成であれば、移行の要点は model の変更だけです：

- "model": "nano-banana-2"
+ "model": "gemini-nano-banana-2.1"

ドキュメントのインターフェースは引き続き POST /v1/tasks です。リクエストが受け付けられると、作成インターフェースはタスク ID を返し、ポーリングやコールバック処理に使用します。既存のポーリングやコールバックのフローはそのまま使用できますが、現在のタスク状態と結果フィールドは引き続き確認する必要があります。

維持できるフィールドと、必ず再確認すべき制限

2.1 の現在の契約では、2 バージョンでよく使われる入力フィールドが維持されています：prompt、省略可能な image_input、aspect_ratio、resolution、output_format。以下の残高のあるスモークテストではテキストからの画像生成と参照画像の両形式が受け付けられましたが、正式に切り替える際はバージョン変化に伴いリアルタイムの契約を確認してください。

参照画像の制限が変更されています。Nano Banana 2 のページには最大 14 枚、1 枚 10 MB と記載されていますが、2.1 のページには最大 10 枚、1 枚 30 MB と記載されています。モデル ID だけを置き換えて古い 14 枚の画像を転送し続けると、リクエストが新版の上限を超えてしまいます。クライアントは新版の上限に従って枚数をチェックし、切り捨てるかユーザーに直接通知するかを決める必要があります。

2.1 のモデルページには mask 入力が公開されていません。移行時に独自に mask フィールドを追加しないでください。後続のインターフェースドキュメントで明示的に提供されない限りは。画像編集では image_input で元画像を渡し、prompt に変更する内容と保持すべき詳細を明記します。

{
  "model": "gemini-nano-banana-2.1",
  "input": {
    "prompt": "Keep the amber glass serum bottle and black dropper cap from the reference image. Place it on a sunlit wooden bathroom counter beside a folded cream linen towel and eucalyptus, preserving the bottle shape and blank label.",
    "image_input": ["https://static.hiapi.ai/blog/gemini-nano-banana-2-1-ecommerce-product-images/studio.jpg"],
    "resolution": "1K",
    "aspect_ratio": "16:9",
    "output_format": "png"
  }
}

このリクエストは残高のあるスモークテストで正常に完了し、結果画像はこちらで確認できます。2.1 のページには現在、参照画像は JPEG、PNG、WebP に対応し、1 枚 30 MB 以下と明記されています。

価格は二段階で確認する

2026-10-16 時点でモデルページを確認したところ、Nano Banana 2.1 の 1K、2K、4K の各プランはそれぞれ 44、72、116 クレジットと表示されています。予算計画の前にリアルタイム価格ページとモデルページを確認してください。課金の読み戻しは別途確認が必要です。

プロモーション価格や特定のアカウントページ上の数字を長期的な固定価格として記載しないでください。本番検証時には解像度、送信前に表示された金額、タスク完了後の実際の課金額を記録してください。

同じプロンプトで 2 つの model ID を切り替える

移行パスを確認するため、2 つの公開 model ID で同じ 1K、1:1 のプロンプトをそれぞれ送信しました。両方のリクエストともタスクの作成に成功し、success に達しました。2 枚の画像ではボトルや台の細部が異なるため、この結果はルーティングと結果処理の確認に適していますが、画質のランキングには不十分で、商品の同一性を証明するものでもありません。

2 回のリクエストで使用したプロンプト：

A clean e-commerce product photograph of a minimalist amber glass skincare serum bottle with a black dropper cap, blank unlabeled bottle, centered on a white marble pedestal, soft studio lighting, warm white background, no lettering

ルート	Model ID	結果
Nano Banana 2	nano-banana-2	1K、1:1、PNG、タスクは正常に完了
Nano Banana 2.1	gemini-nano-banana-2.1	1K、1:1、PNG、タスクは正常に完了

この移行検証から、2.1 の model ID が現在のドキュメントにあるテキストからの画像生成タスク構造を受け付け、同じ非同期フローで画像を返すことが分かります。単一サンプルでの画面の差異は観察にとどめ、モデルの横断評価結果として扱わないでください。

本番前のチェックリスト

1. nano-banana-2 を正確な新版 ID：gemini-nano-banana-2.1 に置き換える。
2. 非同期の POST /v1/tasks フローと既存のタスク状態処理を維持する。
3. image_input が公開画像 URL の配列で、最大 10 枚であることを検証する。
4. 旧版の 1 枚 10 MB という前提を、2.1 のページに現在明記されている 30 MB の制限に変更する。
5. prompt、aspect_ratio、resolution、output_format を維持し、ドキュメントの根拠がないフィールド（例：mask）を削除する。
6. テストアカウントで純テキストのタスクと参照画像編集のタスクをそれぞれ 1 件送信し、リクエスト、タスク ID、最終状態、結果 URL、課金額を保存する。
7. 旧バージョンの結果とエラー処理と一度比較してから、デフォルトモデルを全ユーザーに切り替える。

価格の読み戻しと今後のメンテナンス

上記のスモークテストでは、テキストからの画像生成と画像からの画像生成のリクエスト構造、タスク作成、終態の成功、結果 URL が検証されています。課金は完了したタスクから独立して読み戻していないため、本番コストは引き続きリアルタイム価格ページとタスク記録を基準にしてください。公開前にモデルページの契約や制限が変更された場合も、再確認が必要です。

よくある質問

Nano Banana 2.1 への移行でインターフェースを変更する必要がありますか？

現在、両方のモデルページとも POST /v1/tasks を使用しています。まずモデル ID を変更し、実際のリクエストで入力と返却構造を検証してください。

nano-banana-2 はまだ使用できますか？

この ID は引き続き Nano Banana 2 を表します。2.1 を呼び出す場合は gemini-nano-banana-2.1 を使用してください。

移行後も 14 枚の参照画像を送信できますか？

2.1 のモデルページに現在記載されている上限は 10 枚です。枚数を超える場合はクライアント側で減らすかリクエストを拒否してください。

参照画像編集には別のインターフェースが必要ですか？

現在のページには専用の編集インターフェースはありません。同じモデル ID を使用し、image_input を追加して、プロンプトに変更する内容と保持すべき詳細を記載してください。

2.1 はすべてのアカウントで安くなりますか？

公開ページには現在、各解像度の標準クレジット数が低く表示されていますが、価格は変更される可能性があり、ページもアカウントやキャンペーンの状態に影響されることがあります。コストの結論を出す前に、リアルタイム価格とタスク完了後の課金記録を併せて確認してください。

関連記事

• Nano Banana 2.1 API 導入チュートリアル
• Nano Banana 2.1 API の価格
• Nano Banana 2 API の使い方

HiAPI モデルページで Nano Banana 2.1 を試す。