Skip to main content

​
短い答え

これは Google Aistudio API で知られている問題です。計算負荷が高い場合、生成された画像の大きな純白領域には、黒い斑点、汚れた部分、またはぼやけた色ブロックが出やすくなります。2026年4月以降、繰り返し確認されています。対処法は2つです。
  • Option 1 (try this first): プロンプトを「白い背景」から、薄い色味（薄いグレー、ベージュ、やわらかな青）に変更します。設定変更は不要です。
  • Option 2: サポートに連絡してVertexGemini グループを有効化し、そのグループに紐づけた token を作成します。Vertex チャネルは、きれいな純白の背景を生成します。

​
詳細な説明

高負荷時に、Aistudio の画像パイプラインは、特に純白のような大きな単色領域の圧縮と再構成をうまく処理できません。よく見られるアーティファクトは 3 つあります。
  • 黒い斑点 / 汚れたパッチ: 画像内に局所的な暗い点や不規則な斑点が現れます
  • ぼやけたカラーブロック: 純白の代わりに、かすんだ灰色がかった領域や黄色がかった領域になります
  • 色かぶり: 白い背景が、プロンプトに対して暖色寄り（ベージュ）または寒色寄り（灰青色）にずれます
これはモデルの能力の問題ではありません。均一な背景で発生する Aistudio パイプラインのレンダリング不具合です。Nano Banana Pro や Nano Banana 2 などの Gemini 画像モデルは、Aistudio 経由でルーティングされるといずれも影響を受けます。

​
解決手順

​
オプション 1: プロンプトレベルの回避策（最初に推奨）

プロンプト内の「white background / pure white background / #FFFFFF」を、薄い色味に置き換えます:
  • 薄いグレー: light gray background / #F5F5F5
  • ベージュ: beige background / #F5F0E5
  • 淡い青: light blue background / #E8F0F8
  • 透明: transparent background（モデルが alpha 出力をサポートしている場合）
実際には、純白から薄いグレーやベージュに切り替えるだけで、黒い点や汚れのようなムラをほぼ完全に解消できます。被写体の色には影響せず、変わるのは背景の色味だけです。

​
オプション 2: Vertex チャネルに切り替える

ユースケースで純白の背景が厳密に必要な場合（例: eコマースの商品撮影）、Vertex 経由にすると根本原因を解消できます。

​
VertexGemini グループ参照

​
使い方

1

サポートにアクセスを依頼する

APIYI のサポート / 運用に連絡して、VertexGemini グループを有効化してもらってください。現在は招待制です。
2

専用 token を作成する

APIYI のコンソールにログイン → Token management → Create token → グループ VertexGemini を選択 → キーを保存します。
3

呼び出しを切り替える

新しい token で Nano Banana Pro / Nano Banana 2 を呼び出します。Base URL は同じままです（https://api.apiyi.com/v1）。
VertexGemini グループは同時実行数が限られているため（約100 RPM）、高スループットの本番ワークロードには推奨されません。Aistudio を主チャネルのまま使い、純白背景のテスト時だけ Vertex に切り替えてください。

​
よくある質問

Aistudio の描画問題は、大きな単色領域を圧縮しようとすることで発生します。薄いグレーやベージュに切り替えると背景に少しテクスチャが加わり、アーティファクトを引き起こす「大きな単色領域を圧縮する」条件を避けられます。
必ずしもそうではありません。Vertex は真っ白／単色背景ではより安定していますが、ほかのシーン（複雑な構図、ポートレート）では両者は同程度で、しかも Vertex のほうが遅いです。真っ白が原因だと確認できた場合にのみ切り替えてください。
招待制です — APIYI サポートまたはアカウントマネージャーにお問い合わせください。ほとんどのユーザーには、オプション 1（背景を薄い色に変更する）で十分です。
いいえ。Base URL は https://api.apiyi.com/v1 のままです。変わるのは token のグループだけです。APIYI のバックエンドが Vertex グループのトラフィックを自動的に Vertex プラットフォームへルーティングします。

​
関連ドキュメント

Nano Banana 画像の失敗

Nano Banana 画像モデルにおける一般的な問題とトラブルシューティング。

Google Aistudio と Vertex チャンネルの比較

Aistudio と Vertex の Gemini 画像チャンネルの違いと、選び方。

エンタープライズ向け Vertex フォールバック グループ

エンタープライズのお客様が Vertex グループをフォールバック チャンネルとしてどのように使用するか。

画像非同期 API

非同期の画像生成エンドポイントの使い方。