> ## 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?

> Оптимизация prompt, взвешивание референсных изображений, повторные попытки с несколькими раундами и резервные каналы для сценариев виртуальной примерки одежды — с сравнениями плохих и хороших prompt и пошаговым руководством по устранению неполадок

## Краткий ответ

Искажённые результаты печати с Nano Banana Pro — это не сбой модели, а следствие двух наложенных причин: **внутренней случайности при однократной генерации** плюс **слишком категоричных prompt**. Используйте такой порядок:

1. Сначала воспроизведите проблему с тем же **prompt + reference images** на [imagen.apiyi.com](https://imagen.apiyi.com), чтобы исключить проблемы на стороне клиента
2. Перепишите prompt: уберите абсолютные формулировки вроде «жёстко зафиксировать» или «восстановить пиксель-в-пиксель»; вместо этого используйте конкретные описания цвета / позиции / сохраняемого объекта
3. Загрузите чёткие, хорошо различимые reference images с использованием **Base64 encoding** (серия Nano Banana НЕ поддерживает загрузку по URL в стиле OpenAI)
4. Включите повторные попытки multi-roll: пусть ваш бизнес-код автоматически повторяет тот же prompt 1\~3 раза
5. Если и это не поможет, смените канал или model: по умолчанию banana pro использует AI Studio — переключитесь на [Vertex group](/ru/faq/google-upstream-aistudio-vertex), либо попробуйте [gpt-image-2 series](/ru/api-capabilities/gpt-image-2-all/image-edit) (у которой стиль редактирования ближе к исходному)

## Почему результаты искажаются

Генерация изображений с помощью ИИ — это **одноразовая атомарная выборка**: каждый вызов является независимым сэмплом, без переключателя «strict restore». Два самых частых источника проблемы:

* **Слишком категоричная формулировка prompt**: фразы вроде «строго зафиксируй положение», «восстанови пиксель в пиксель» или «воссоздай 1:1» могут заставить модель интерпретировать запрос как «перерисуй это», и печать будет перерисована вместе со всем остальным
* **Неверный формат загрузки reference-image**: серия Nano Banana поддерживает **только загрузку, закодированную в Base64**. Если вставить URL напрямую в совместимое с OpenAI поле `image_url`, модель «не увидит» референс, и печать сможет свободно сместиться

<Info>
  Даже при идеальном описании модель всё равно будет «уходить» примерно в **5%\~15%** одноразовых сэмплов. Это не дефект — это **неотъемлемо для генеративных моделей**: один и тот же prompt естественным образом даёт разные результаты при каждом вызове.
</Info>

## Пошаговое устранение неполадок

<Steps>
  <Step title="Воспроизведите в тестовом инструменте, чтобы исключить проблемы на стороне клиента">
    Откройте [imagen.apiyi.com/#generate](https://imagen.apiyi.com/#generate) и снова запустите **тот же самый prompt + референсные изображения**:

    * Принт также искажается в инструменте → скорее всего, проблема в **prompt**, перейдите к шагу 2
    * Принт сохраняется в инструменте → отладьте свою интеграцию (изображение действительно загружено? параметры корректны?), см. [Сгенерированное изображение слишком сильно отличается от референса](/ru/faq/image-result-differs-from-reference)
  </Step>

  <Step title="Перепишите prompt, уберите абсолютные формулировки">
    Замените командный стиль вроде «строго восстановить» или «пиксель-в-пиксель» на **конкретные описания атрибутов** (см. «Примеры оптимизации prompt» ниже).
  </Step>

  <Step title="Убедитесь, что референсные изображения загружены корректно">
    * Серия Nano Banana **НЕ поддерживает загрузку URL в формате OpenAI** — нужно использовать **Base64**
    * Референсные изображения должны быть **чёткими и содержательными**: размытые или перегруженные референсы заставляют модель «гадать», из-за чего принты чаще съезжают
    * Одно изображение ≤ **7MB** (официальный лимит Gemini) — перед загрузкой рекомендуется сжатие без потерь
    * Каждый prompt принимает до **14 референсных изображений**; если нужно сохранить только один принт, загрузите только этот крупный план и увеличьте его вес
  </Step>

  <Step title="Включите повторные попытки с несколькими прогонами (автоповтор)">
    В вашем бизнес-коде реализуйте **1\~3 автоматические повторные попытки** для одного и того же prompt. Одна неудачная попытка не означает, что модель сломалась — несколько прогонов существенно повышают процент попаданий.
  </Step>

  <Step title="Переключите канал или модель в качестве запасного варианта">
    * Переключитесь на **группу Vertex** (просто выберите группу Vertex при редактировании token в консоли — изменения кода не нужны) — модерация Vertex отличается от модерации AI Studio, и некоторые запросы на смену одежды, которые в AI Studio ошибочно помечаются, на Vertex проходят без проблем
    * Или попробуйте **серия gpt-image-2** — её стиль редактирования ближе к исходному изображению, с меньшим смещением цветов и стиля, идеально, когда приоритет — «остаться как можно ближе к оригиналу»
  </Step>
</Steps>

## Примеры оптимизации prompt

Ниже приведена сравнительная таблица «плохо — хорошо» для сценария замены образа + сохранения принта:

| Стиль написания                    | ❌ Плохой пример                                  | ✅ Улучшенный вариант                                                                             |
| ---------------------------------- | ------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| Будьте конкретны в отношении цвета | «Измени на чёрный»                               | «Измени на **матовый чисто чёрный**, сохрани исходную текстуру материала»                        |
| Опишите расположение принта        | «Принт должен оставаться строго зафиксированным» | «Принт на груди — **позиция, цвет, пропорции, компоновка** — всё должно остаться точно таким же» |
| Перечислите, что нужно сохранить   | «Всё остальное без изменений»                    | «Цвет, положение и текстовые подписи всех остальных объектов должны остаться без изменений»      |
| Разделяйте действия                | Упаковать 5 правок в одно предложение            | Разделите на несколько правок — **меняйте по одной вещи за раз**                                 |

**Улучшенный полный пример prompt**:

> Отредактируйте это изображение. Выполните две задачи: ① Измените два чайника внутри красной рамки на матовый чисто чёрный цвет, сохранив исходную текстуру материала и форму; ② Удалите саму красную рамку. Цвет, положение, размерные подписи и текст всех остальных объектов на изображении должны **остаться полностью без изменений**.

<Tip>
  **Общий принцип: меняйте по одной категории за один вызов.** Если для замены образа вам нужно «изменить цвет + изменить фон + добавить текст», разделите это на несколько правок — вероятность успеха каждого вызова будет заметно выше, чем у одной мегакоманды.
</Tip>

## Об общем красном/тёплом оттенке

Если после замены вы заметите, что всё изображение уходит в красный или тёплый оттенок, это **другая** проблема — её обычная причина: [результаты редактирования banana pro с общим красным оттенком](/ru/faq/banana-pro-edit-red-cast). Причины и способы исправления отличаются от искажения при печати (переключитесь на канал Vertex или откатитесь на gpt-image-2).

## Связанные документы

* [Руководство для разработчиков серии Nano Banana](/ru/api-capabilities/nano-banana-dev-guide) — модельный ряд, тарификация, требования к загрузке через Base64
* [Сгенерированное изображение слишком сильно отличается от эталона](/ru/faq/image-result-differs-from-reference) — отладка неверных форматов эталона
* [Работают ли модели Google в AI Studio или Vertex?](/ru/faq/google-upstream-aistudio-vertex) — как переключиться на группу Vertex
* [Как генерировать изображения, которые вас устраивают](/ru/api-capabilities/image-generation-success-tips) — четыре стратегии: переписывание prompt, повторная попытка, смена модели, разбор с помощью test-tool
* [Руководство по обработке ошибок API генерации изображений Gemini](/ru/api-capabilities/gemini-image-error-handling) — отладка неудачных / заблокированных генераций
* [Распространённые причины, по которым генерация изображений серии Nano Banana завершается сбоем](/ru/faq/nano-banana-image-failure) — сценарии блокировки из-за требований к безопасности контента
* [Результат редактирования banana pro с общим красноватым оттенком](/ru/faq/banana-pro-edit-red-cast) — проблема общего цветового сдвига

## Свяжитесь со службой поддержки

Если шаги выше всё ещё не помогают, свяжитесь со службой поддержки в рабочем пространстве или напишите на [hi@apiyi.com](mailto:hi@apiyi.com) с указанием:

* Результата воспроизведения того же prompt в [imagen.apiyi.com](https://imagen.apiyi.com) (скриншот или ссылка)
* Названия модели, которую вы используете (например, `gemini-3-pro-image-preview` / Nano Banana 2)
* Времени вызова API + request ID (если доступно)