> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nano Banana Proで衣装を変更したときにプリントの歪みを修正するには？

> 試着シナリオ向けのプロンプト最適化、参照画像の重み付け、複数回の再試行、チャネルのフォールバック — 悪いプロンプトと良いプロンプトの比較および段階的なトラブルシューティングガイド付き

## 簡潔な回答

Nano Banana Pro で歪んだ出力が出るのはモデルの失敗ではなく、**単発生成に内在するランダム性**と**過度に強い prompt**という 2 つの要因が重なって起きます。次の順で試してください。

1. まず、[imagen.apiyi.com](https://imagen.apiyi.com) で**同じ prompt + 参考画像**を使って再現し、クライアント側の問題を切り分けます
2. prompt を書き直します: 「strictly lock」や「pixel-perfect restore」のような絶対的な表現は हटして、代わりに具体的な色 / 位置 / 保持する要素の説明を使います
3. **base64 エンコーディング**で、鮮明で判別しやすい参考画像をアップロードします（Nano Banana 系列は OpenAI 形式の URL アップロードをサポートしていません）
4. マルチロール再試行を有効にします: ビジネスコードで同じ prompt を 1〜3 回自動再試行します
5. それでもうまくいかない場合は、チャネルまたはモデルを切り替えます: banana pro の既定は AI Studio なので、[Vertexグループ](/ja/faq/google-upstream-aistudio-vertex) に切り替えるか、[gpt-image-2 シリーズ](/ja/api-capabilities/gpt-image-2-all/image-edit) を試してください（こちらは編集スタイルが元画像により近く保たれます）

## プリントが崩れる理由

AI画像生成は**単発のアトミックサンプリング**です。各呼び出しは独立した抽選であり、"strict restore" の切り替えはありません。最もよくある原因は次の2つです。

* **プロンプトの言い回しが強すぎる**: "strictly lock in place"、"pixel-perfect restore"、"1:1 reproduce" のような表現は、モデルに「それを描き直す」と解釈させてしまい、プリントも他の要素と一緒に描き直されます
* **参照画像のアップロード形式が誤っている**: Nano Banana シリーズは **Base64エンコードされたアップロードのみ対応** です。OpenAI互換の`image_url`フィールドにURLをそのまま貼り付けると、モデルが参照画像を「見られない」ため、プリントが自由にずれてしまいます

<Info>
  どれだけ完璧に説明しても、モデルは単発サンプルのうちおおよそ **5%\~15%** では、なお「wander」することがあります。これは欠陥ではなく、**生成モデルに固有の性質**です。同じ prompt でも、呼び出しごとに自然と異なる結果になります。
</Info>

## 段階的なトラブルシューティング

<Steps>
  <Step title="テストツールで再現してクライアント側の問題を切り分ける">
    [imagen.apiyi.com/#generate](https://imagen.apiyi.com/#generate) を開き、**まったく同じ prompt + reference images** で再度実行します:

    * ツール内でもプリントが崩れる → ほぼ **prompt** の問題です。手順 2 に進んでください
    * ツール内ではプリントが維持される → 連携実装をデバッグしてください（画像は実際にアップロードされていますか？ パラメータは正しいですか？）。[生成画像が参照画像と大きく異なりすぎる場合](/ja/faq/image-result-differs-from-reference)を参照してください
  </Step>

  <Step title="prompt を書き直し、断定的な表現を避ける">
    「厳密に復元する」や「ピクセル単位で完全一致」のような命令調の表現は、**具体的な属性の説明** に置き換えてください（下の「prompt 最適化の例」を参照）。
  </Step>

  <Step title="参照画像が正しくアップロードされていることを確認する">
    * Nano Banana シリーズは **OpenAI形式のURLアップロードをサポートしていません** — **Base64** を使用する必要があります
    * 参照画像は **鮮明で特徴が豊富** である必要があります。ぼやけた参照画像や情報量の少ない参照画像では、モデルは「推測」せざるを得ず、プリントがずれやすくなります
    * 1枚あたり **7MB** 以下です（Gemini の公式上限）— アップロード前には無劣化圧縮を推奨します
    * 各 prompt では最大 **14 枚の参照画像** を受け付けます。1つのプリントだけを保持したい場合は、そのクローズアップだけをアップロードし、重みを上げてください
  </Step>

  <Step title="複数回試行の再試行（自動再試行）を有効にする">
    本番コードでは、同じ prompt に対して **1〜3 回の自動再試行** を実装してください。1回失敗したからといってモデルが壊れているわけではありません。試行回数を増やすほどヒット率は大きく上がります。
  </Step>

  <Step title="フォールバックとしてチャネルまたはモデルを切り替える">
    * **Vertex グループ** に切り替える（console で token を編集するときに Vertex グループを選ぶだけでよく、コード変更は不要です）— Vertex のモデレーションは AI Studio のものと異なり、AI Studio で誤ってフラグ付けされる一部の服装差し替えリクエストも Vertex では問題なく通ります
    * または **gpt-image-2 シリーズ** を試してください — 編集スタイルが元画像により近く、色ずれやスタイルの変化が少ないため、「元の画像にできるだけ近い」ことを優先する場合に最適です
  </Step>
</Steps>

## Prompt最適化の例

以下は、衣装の差し替え + プリント保持シナリオに関する、悪い例と良い例の比較表です:

| 書き方          | ❌ 悪い例               | ✅ 改善版                                     |
| ------------ | ------------------- | ----------------------------------------- |
| 色を具体的に指定する   | "黒に変更"              | "**つや消しの真っ黒**に変更し、元の素材感を保持する"             |
| プリントの位置を説明する | "プリントは厳密に固定したままにする" | "胸のプリントの **位置、色、比率、レイアウト** はすべてまったく同じに保つ" |
| 保持するものを列挙する  | "それ以外はすべて変更なし"      | "他のすべてのオブジェクトの **色、位置、テキストラベル** は変更しない"   |
| 操作を分ける       | 5つの編集を1文に詰め込む       | 複数の編集に分ける — **一度に1つだけ変更する**               |

**改善した完全な Prompt 例**:

> この画像を編集してください。2つのことを行います。① 赤枠内の2つのティーポットを、元の素材感と形状を保ったまま、つや消しの真っ黒に変更する。② 赤枠の輪郭そのものを削除する。画像内の他のすべてのオブジェクトの色、位置、寸法ラベル、テキストは、**完全に変更しないでください**。

<Tip>
  **一般原則: 1回の呼び出しで1つのカテゴリだけを変更してください。** 衣装の差し替えで「色を変更 + 背景を変更 + テキストを追加」が必要な場合は、複数回の編集に分けてください — 各呼び出しの成功率は、1つの巨大な指示にまとめるよりも明らかに高くなります。
</Tip>

## 全体的な赤み／暖色寄りの色かぶりについて

スワップ後に画像全体が赤みを帯びたり暖色寄りに見えたりする場合、それは**別の**問題です。通常の原因は [banana pro の編集結果で全体に赤みが出る](/ja/faq/banana-pro-edit-red-cast) ことです。原因と対処法は印刷の歪みとは異なります（Vertex チャネルに切り替えるか、gpt-image-2 にフォールバックしてください）。

## 関連ドキュメント

* [Nano Bananaシリーズ開発ガイド](/ja/api-capabilities/nano-banana-dev-guide) — モデル一覧、価格、Base64アップロード要件
* [生成された画像が参照画像と大きく異なりすぎる](/ja/faq/image-result-differs-from-reference) — 誤った参照形式のデバッグ
* [GoogleモデルはAI Studioで動作しますか、それともVertexですか？](/ja/faq/google-upstream-aistudio-vertex) — Vertexグループへの切り替え方法
* [満足できる画像を生成する方法](/ja/api-capabilities/image-generation-success-tips) — 4つの戦略：promptの書き換え、再試行、モデルの切り替え、テストツールでの切り分け
* [Gemini画像APIのエラーハンドリングガイド](/ja/api-capabilities/gemini-image-error-handling) — 失敗した／ブロックされた生成のデバッグ
* [Nano Bananaシリーズの画像生成が失敗する一般的な理由](/ja/faq/nano-banana-image-failure) — コンテンツセーフティのブロックシナリオ
* [banana pro editの結果が全体的に赤みを帯びる](/ja/faq/banana-pro-edit-red-cast) — 全体的な色かぶりの問題

## サポートに連絡する

上記の手順でも解決しない場合は、ワークスペース内のサポートに連絡するか、[hi@apiyi.com](mailto:hi@apiyi.com) までメールで以下をお送りください。

* [imagen.apiyi.com](https://imagen.apiyi.com) で同じ prompt を再現した結果（スクリーンショットまたはリンク）
* ご利用のモデル名（例: `gemini-3-pro-image-preview` / Nano Banana 2）
* API 呼び出しのタイムスタンプ + リクエスト ID（利用可能な場合）