簡単な答え
gemini-3-pro-image、Banana Pro、または Banana 2 を使用している場合、生成画像と参照画像の差が大きくなる原因は、通常、参照画像のアップロード形式の不一致です。
- これらのモデルは OpenAI 形式の参照画像アップロードをサポートしていません
- 参照画像は base64 文字列 としてアップロードする必要があります
- 問題はモデル自体ではなく、統合方法に関連しています
トラブルシューティング手順
次の確認を順番に実施してください:1
Webコンソールでモデルをテストする
imagen.apiyi.comを開き、同じ参照を Web UI で実行してください。Web の結果が参照と一致する場合、モデルは正常に動作しており、問題は統合側にあります。Web の結果も異なる場合は、次の確認に進んでください。2
トークングループを確認する
APIYI コンソールで、トークンに
gemini-3-pro-image または Bananaシリーズのモデルグループが含まれていることを確認してください。モデルが有効になっていない場合、呼び出しはデフォルトの動作にフォールバックし、予期しない結果になることがあります。3
課金モードを確認する
トークン設定で、課金モードを確認してください:
- 従量課金優先: 従量課金とサブスクリプションのクォータの両方を使用します
- 従量課金のみ: 従量課金のクォータのみが利用できます
4
統合方法を確認する
公式のモデルドキュメントと照らし合わせて、リクエストを再確認してください。Banana 2 の場合:
docs.apiyi.com/api-capabilities/nano-banana-2-image/image-edit次の点に注意してください:- reference フィールドは URL ではなく、base64 文字列 を想定しています
- MIME タイプは実際の画像形式と一致していなければなりません
- パラメータの形は、このモデルがサポートする内容と一致していなければなりません
よくある原因
関連する質問
Nano Banana 画像生成の失敗
Nano Banana モデルでよくある問題と対処法です。
画像非同期 API
画像非同期タスクのエンドポイントの使い方です。
Base URL の設定方法
さまざまなクライアントツールで APIYI を接続します。
token モデルのホワイトリスト
token がアクセスできるモデルを設定します。