nano-banana-2 API — AI API ゲートウェイ経由で利用する

nano-banana-2 は Google の Gemini 画像モデルで、画像生成と画像編集の両方に強く、とりわけ複数参照画像の合成(最大 6 枚)を得意としています。AI API ゲートウェイである byesu の OpenAI 互換画像 API を通じて呼び出せます。リクエストは公式モデルにルーティングされ、品質劣化はありません。課金は枚数単位で $0.025 / 枚、解像度は 1K / 2K / 4K をカバーします。同じプラットフォームで Claude、GPT-5.6、Grok、Gemini のテキストモデルも利用でき、サブスクリプション不要の従量課金です。

このページでは、そのままコピーして実行できる接続サンプルを提供します。コンソール登録は byesu.com から、メディア API の完全なドキュメントは docs.byesu.com/ja/media をご覧ください。

一言でまとめると:何のモデルで、いくらか

• モデル:nano-banana-2(Google Gemini 画像)。テキストから画像と画像から画像を一体化しており、複数参照画像の合成が特に優秀です
• 料金:$0.025 / 枚の枚数課金。1K / 2K / 4K の解像度はすべて size パラメータで指定します
• 接続方法:OpenAI 互換 API、Base URL は https://byesu.com/v1、トークンは media / media-gen グループを使用します

トークンは正しいグループで作成してください

画像モデル用のトークンは必ず media / media-gen グループに属している必要があります。そうでないと「利用可能なチャネルがありません」というエラーになります。コンソール でトークンを作成する際、「グループ」のドロップダウンから選択するだけです。詳しくは グループの選択 を参照してください。

呼び出し方法

準備:トークンを取得する

1. コンソール を開いてログイン → 左サイドバーの トークン → トークンを追加
2. グループを media / media-gen に設定し、名前と利用枠を設定 → 送信
3. 発行された sk-xxxxxxxx 形式のトークンをコピーします

テキストから画像(curl)

テキストから画像は POST /v1/images/generations に送信し、PNG の base64 を同期的に返します:

curl https://byesu.com/v1/images/generations \
  -H "Authorization: Bearer sk-your-token" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "nano-banana-2",
    "prompt": "夕暮れの金色の麦畑を駆け抜けるゴールデンレトリバー、シネマティック、浅い被写界深度",
    "size": "2048x1152"
  }'

レスポンス:

{ "data": [ { "b64_json": "<base64 string>" } ] }

テキストから画像(Python)

import base64, requests

resp = requests.post(
    "https://byesu.com/v1/images/generations",
    headers={"Authorization": "Bearer sk-your-token"},
    json={
        "model": "nano-banana-2",
        "prompt": "サイバーパンクの雨の夜の街並み、ネオンの反射、4K フォトリアル",
        "size": "3840x2160",   # 長辺 ≈3840 → 4K
    },
).json()

b64 = resp["data"][0]["b64_json"]
open("out.png", "wb").write(base64.b64decode(b64))

画像から画像 / 複数参照画像の合成(nano-banana-2 の得意分野)

画像から画像は POST /v1/images/edits に multipart/form-data 形式で送信します。参照画像はファイルとしてアップロードし、フィールド名 image は繰り返し指定して複数枚を送信できます(nano-banana-2 の上限は 6 枚、各画像 ≤8MB):

curl https://byesu.com/v1/images/edits \
  -H "Authorization: Bearer sk-your-token" \
  -F model="nano-banana-2" \
  -F prompt="この 3 枚の写真の人物を同じ海辺のシーンに合成し、ライティングを統一する" \
  -F size="2048x2048" \
  -F image=@person1.png \
  -F image=@person2.png \
  -F image=@scene.png

レスポンス形式はテキストから画像と同じです(data[0].b64_json)。Python では files=[("image", open(p,"rb")) for p in paths] で複数枚を渡せます。

主要パラメータ

パラメータ	エンドポイント	必須	説明
model	両方	✅	常に nano-banana-2 を指定します。大文字小文字とハイフンを正確に一致させてください
prompt	両方	✅	テキストプロンプト。主体 + シーン + スタイル + ライティングを明確に書くと、より良い結果になります
size	両方		幅x高さのピクセル数で、アスペクト比と解像度ランクを同時に決定します:長辺 ≈1024 → 1K、≈2048 → 2K、≈3840 → 4K。例:"1024x1024"(1:1・1K)、"2048x1152"(16:9・2K)、"3840x2160"(16:9・4K)。省略した場合は 1:1 の基本ランクになります
image	edits のみ		参照画像のファイルフィールドで、繰り返し指定して複数枚を送信可能。nano-banana-2 の上限は 6 枚、各画像 ≤8MB

課金は「枚数」のみで決まり、解像度ランクとは無関係です:$0.025 / 枚。コンソールで各呼び出しの実際の課金額を確認できます。

nano-banana-2 の利用に byesu を使う理由

• 公式モデルで品質劣化なし:リクエストは公式サービスにルーティングされます。リバースエンジニアリング・ミラー・クラックの類ではないため、出力品質は公式サービスと同等です
• 透明な枚数課金:nano-banana-2 は $0.025 / 枚。コンソールで実際の課金額と公式の定価を並べて確認でき、使った分だけの支払いです
• 失敗時は自動返金:メディアタスクの生成に失敗した場合、料金は自動的に返金されます。失敗した画像に支払う必要はありません
• 複数参照画像にフレンドリー:/v1/images/edits での複数枚アップロードをネイティブにサポートし、最大 6 枚の参照画像から合成するという nano-banana-2 の強みをそのまま活かせます
• 1 つの API であらゆるモデル:同じ OpenAI 互換 API で他の画像 / 動画 / テキストモデルも呼び出せます。モデルの切り替えは model フィールドを変えるだけです
• サブスクリプション不要の従量課金:USDT・Alipay・WeChat Pay でチャージし、生成した画像の分だけ支払います

関連リンク

• メディア API 概要(画像 / 動画 API)
• 画像生成モデルとパラメータ
• クイックスタート:3 ステップで接続
• グループの選択(トークン作成前の必読)
• コンソール登録 / トークン作成

よくある質問

nano-banana-2 API へのアクセス方法を教えてください。

byesu コンソールで登録し、media / media-gen グループのトークンを作成して、Base URL https://byesu.com/v1 の OpenAI 互換エンドポイント /v1/images/generations と /v1/images/edits 経由で nano-banana-2 を呼び出します。byesu は AI API ゲートウェイで、同じプラットフォームで Claude、GPT-5.6、Grok、Gemini も利用でき、サブスクリプション不要の従量課金です。

nano-banana-2 API は 1 枚あたりいくらですか?

byesu では nano-banana-2 を $0.025 / 枚で課金します。解像度ランク(1K/2K/4K)にかかわらず枚数単位の課金です。生成に失敗した場合は自動的に返金され、コンソールで各呼び出しの実際の課金額を確認できます。

nano-banana-2 で複数参照画像の合成を行うにはどうすればよいですか?

POST /v1/images/edits(multipart 形式)を呼び出し、各参照画像をファイルとして image フィールドに入れます。このフィールドは繰り返し指定でき、複数枚をアップロードできます。nano-banana-2 は最大 6 枚の参照画像(各 8MB 以下)に対応しており、複数の人物や要素を 1 つのシーンに合成する用途に最適です。

Claude Code などのクライアントアプリで nano-banana-2 を使えますか?

nano-banana-2 は画像生成モデルで、chat API ではなく /v1/images/generations と /v1/images/edits エンドポイント経由で呼び出すため、Claude Code 内でチャットモデルとして使うものではありません。curl や Python で直接呼び出すか、byesu の生成ワークベンチで選択して利用できます。Claude Code、Codex、Cherry Studio などのクライアントに接続するのはテキスト / コーディングモデルです。

nano-banana-2 はどの解像度とアスペクト比に対応していますか?

1K / 2K / 4K の 3 ランクに対応し、size パラメータ(幅x高さのピクセル数)で指定します。長辺が約 1024 なら 1K、約 2048 なら 2K、約 3840 なら 4K です。よく使われるアスペクト比は 1:1、16:9、9:16、4:3、3:4 で、たとえば 2048x1152 は 16:9 の 2K です。

nano-banana-2 を呼び出すと「利用可能なチャネルがありません」というエラーが出ます。どうすればよいですか?

ほとんどの場合、トークンのグループ設定の誤りが原因です。画像モデル用のトークンは media / media-gen グループに属している必要があります。コンソールでそのグループのトークンを新規作成し、model が nano-banana-2(大文字小文字とハイフンが一致)に設定されていることを確認すれば解消します。