Этот Nano Banana 2 API guide предназначен для команд, которым нужен маршрут обработки изображений, который можно протестировать, проверить и запустить. Название модели — это отправная точка, а не подтверждение того, что маршрут, параметр, квота или цена доступны сегодня. Перед интеграцией откройте каталог моделей изображений OdiRouter.category=Image), подтвердите актуальную запись и ознакомьтесь с документацией по конкретной модели.
OdiRouter объединяет каталог моделей, цены и документацию по API. Используйте каталог, чтобы проверить идентификатор модели и категорию. Используйте документацию, чтобы проверить поля запроса и обработку ответа. Используйте current OdiRouter pricing для определения цены, влияющей на решение о выпуске.
Начните с актуального каталога
Названия, псевдонимы, параметры и цены меняются. Руководство может помочь спланировать тест, но не может заменить актуальную запись. В инженерной заметке зафиксируйте:
текущий идентификатор модели;
типы входных данных, которые принимает маршрут;
документированные параметры размера изображения, соотношения сторон, формата вывода и референсных изображений;
конечную точку запроса, а также конечные точки статуса или ответа; и
единицу тарификации и ограничения, влияющие на ожидаемую нагрузку.
Если точная запись отсутствует, не заменяйте её маршрутом с похожим названием. Выберите представленный в списке маршрут, чьё документированное поведение соответствует задаче, либо приостановите работу до появления нужного маршрута. Это позволяет отделить требования к продукту от поискового запроса.
Сначала выполните небольшой запрос
Документация OdiRouter описывает аутентификацию с помощью API-ключа Bearer и запросы к очереди моделей изображений, которые возвращают идентификатор запроса и URL-адреса для последующей проверки статуса или ответа. Перед копированием полей запроса проверьте документацию выбранного маршрута. Этот пример остаётся параметризованным, поскольку модели изображений поддерживают разные поля.
curl --request POST "https://api.odirouter.ai/model/v1/queue/YOUR_IMAGE_MODEL_ID" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A simple product image for a controlled test",
"width": 1024,
"height": 1024
}'Используйте только поля, задокументированные для выбранной модели. Сохраняйте возвращённый идентификатор запроса вместе с идентификатором модели, версией промпта, идентификаторами входных ресурсов и временем запроса. Если ответ содержит отдельные URL-адреса статуса и результата, следуйте документации модели, а не рассматривайте маршрут как синхронную текстовую конечную точку.
Для настройки учётной записи и основ работы с API-ключами используйте OdiRouter getting-started documentation. Не допускайте попадания ключей в код браузера, скриншоты, трекеры задач и тестовые фикстуры.
Проверяйте результаты своей работы перед выпуском.
Одно удачное изображение не доказывает, что маршрут готов к использованию в производственной среде. Создайте небольшой, версионированный набор, который будет отражать работу, выполняемую вашим продуктом. При создании изображений следует учитывать композиции продукта, текстовые подсказки, различные соотношения сторон, ограничения, накладываемые брендом, и известные случаи сбоев. Для редактирования используйте утверждённые входные изображения и изменения, которые должны сохранять объект, изменяя при этом определённую деталь.
Определяйте критерий приёмки до запуска каждого элемента. Проверяйте, соответствует ли результат запрошенной композиции, сохраняет ли необходимые детали эталона, имеет ли совместимые размеры и тип файла, а также содержит ли достаточно контекста, чтобы проверяющий мог классифицировать сбой. Не следует сводить обзор к простому ранжированию моделей.
Сохраняйте тестовые входные данные, идентификатор модели, идентификаторы результатов, решение по проверке и категорию сбоя. Затем вы сможете сравнить последующее обновление модели с теми же доказательствами.
Рассматривайте пакеты как операционную работу
Наиболее сложные аспекты обычно проявляются после того, как маршрут срабатывает для одного промпта. Для пакета необходимы отслеживание на уровне элементов, восстановление после отдельных сбоев и достаточный контекст для проверяющего. Ведите отдельную запись для каждого элемента:
Поле | Почему это важно |
|---|---|
Идентификатор запроса | Связывает элемент с его операцией API и проверками статуса. |
Идентификатор модели | Показывает, какой маршрут создал результат. |
Версия промпта | Позволяет отличить изменение модели от изменения промпта. |
Идентификаторы входных и эталонных ресурсов | Сохраняет доказательства, использованные для получения результата. |
Расположение и размеры результата | Позволяет последующим системам проверить доставленный файл. |
Решение проверяющего и категория сбоя | Поддерживает целевые повторные попытки вместо полного повторного запуска пакета. |
Число повторных попыток | Показывает, когда элементу требуется проверка или другой маршрут. |
Запустите небольшой пакет, прежде чем планировать более крупный. Уточните, как выбранный маршрут OdiRouter сообщает о позиции в очереди, завершении, ошибках и расположении результатов. Если один элемент не удаётся обработать, повторяйте попытку только для него и лишь после того, как поймёте причину сбоя. Тайм-аут, ошибка валидации и отклонение при проверке — это разные случаи.
Определите границы резервного сценария и проверки
Резервный сценарий — это продуктовое решение, а не скрытый цикл повторных попыток. Укажите утвержденный альтернативный маршрут, условия запуска и случаи, требующие рассмотрения человеком. Триггерами могут быть отсутствие маршрута, ошибка API, превышение целевого времени отклика или повторяющийся сбой приёмочного теста.
Не передавайте конфиденциальные, защищенные правами доступа или неисправные клиентские активы другому поставщику без утвержденной политики. В случаях, когда результат соответствует требованиям бренда или законодательства, окончательное решение должен принимать рецензент.
Перед запуском проверьте стоимость и доступность.
Откройте OdiRouter pricing page при планировании развёртывания. Отображение цен, доступность и ограничения — это операционные входные данные, которые могут меняться. Зафиксируйте в записи о запуске дату, маршрут, единицу тарификации и предположение о рабочей нагрузке.
Затем отправьте небольшой запрос, аналогичный запросу для производственной среды, через учетную запись и путь интеграции, которые вы будете использовать после релиза. Это подтверждает, что аутентификация, выбранный маршрут, документированная структура запроса и обработка результатов на последующих этапах работают согласованно. Сохраняйте записи запросов и настройте оповещения, поскольку один тест не может доказать, что каждый будущий запрос будет успешным.
Контрольный список для релиза
Текущий каталог OdiRouter содержит точный маршрут, а его документация поддерживает отправляемые вами поля.
Версионированный набор для оценки прошёл критерии приёмки, определённые вашей командой.
Записи о пакетах содержат идентификаторы запросов, идентификаторы моделей, входные данные, результаты, решения и данные о повторных попытках.
У команды есть утверждённый резервный сценарий и граница передачи на проверку человеком.
Проверены текущая запись о цене и ожидаемый объём релиза.
Ключи API, исходные материалы и права клиентов соответствуют вашим требованиям безопасности и политики.
Часто задаваемые вопросы
Гарантирует ли это руководство доступность конкретного маршрута Nano Banana 2?
Нет. Перед созданием или выпуском интеграции подтвердите точную текущую запись в каталоге моделей изображений OdiRouter.
Следует ли копировать цены в документ по реализации?
Используйте датированную запись о запуске с текущей записью о цене OdiRouter и предположениями о рабочей нагрузке. Не полагайтесь на старую статическую таблицу, когда для решения о релизе требуется актуальная цена.
Что делать, если элемент пакета не удаётся обработать?
Сохраните запись запроса, классифицируйте сбой и повторите попытку только для затронутого элемента, если это уместно. Направляйте повторяющиеся сбои качества, вопросы политики и случаи, связанные с чувствительными правами, по определённому вами пути проверки.