Nano Banana 2 API: руководство по настройке OdiRouter

Редакция OdiRouter

Nano Banana 2 API на OdiRouter позволяет серверной части отправлять задания на генерацию или редактирование изображений, сохранять идентификатор запроса и получать результат после завершения обработки. В документации OdiRouter указана Nano Banana 2 как модель изображений Google Gemini для генерации изображений, редактирования изображений и компоновки нескольких изображений. Практическая часть заключается в жизненном цикле запроса: отправьте задание, сохраните идентификатор, проверьте статус, затем получите результат по указанному в документации URL-адресу.

Начните с документации OdiRouter

Перед отправкой запроса в производство ознакомьтесь с документом OdiRouter Nano Banana 2 model page и документом official API reference. На этих страницах указаны конечная точка, поля запроса и URL-адреса, возвращаемые для проверки статуса и получения результата.

Базовый URL-адрес, указанный в документации, — https://api.odirouter.ai/model. В каждом запросе используется API-ключ bearer. Храните ключ в хранилище секретных данных на стороне сервера или в переменной окружения. Ему не место в коде браузера, системе контроля версий или общедоступном промпте.

Отправьте задание на обработку изображения

Создайте задачу с помощью POST /v1/queue/nano-banana-2. Поле prompt является обязательным, а официальная документация допускает промпты длиной от 1 до 2500 символов. Добавьте image_urls, если запросу нужны визуальные референсы.

curl --request POST "https://api.odirouter.ai/model/v1/queue/nano-banana-2" \
  --header "Authorization: Bearer $ODIROUTER_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "prompt": "A product photograph of a red backpack on a light stone surface, soft studio lighting.",
    "image_urls": ["https://example.com/reference-image.webp"],
    "aspect_ratio": "1:1",
    "image_size": "2K",
    "response_modalities": ["Image"]
  }'

URL-адрес изображения в этом примере является заполнителем. В реальном приложении отправляйте только те изображения, на использование которых у вас есть разрешение, и проверяйте каждый URL-адрес перед выполнением вызова API.

Укажите поля, соответствующие вакансии.

В справочнике OdiRouter описаны следующие элементы управления:

  • image_urls принимает до трёх URL-адресов входных изображений для референсных изображений или визуального контекста.

  • aspect_ratio поддерживает 1:8, 1:4, 1:1, 2:3, 3:2, 3:4, 4:1, 4:3, 4:5, 5:4, 8:1, 9:16, 16:9 и 21:9.

  • image_size принимает 512, 1K, 2K или 4K.

  • response_modalities управляет типами возвращаемых результатов. Документированное значение по умолчанию — ["Text", "Image"]; передавайте ["Image"], если рабочему процессу требуется только ответ с изображением.

Выберите поля, соответствующие нужному вам результату. Для квадратного изображения для каталога и широкого баннера для кампании требуются разные соотношения сторон. Референсное изображение изменяет визуальный контекст, предоставляемый модели, поэтому обращайтесь с ним так же тщательно, как и с другими входными данными.

Управление жизненным циклом асинхронного запроса

Вызов создания возвращает request_id, а также status_url, response_url и cancel_url. Сохраните идентификатор запроса в своей записи о задании. Вы можете использовать его для проверки задачи, получения результата или отмены работы, которая больше не актуальна.

Документированный жизненный цикл довольно прост:

  1. Отправьте запрос на изображение в /v1/queue/nano-banana-2.

  2. Выполняйте опрос /v1/queue/nano-banana-2/requests/{request_id}/status из воркера или контроллера задач.

  3. Получите завершенный вывод по адресу /v1/queue/nano-banana-2/requests/{request_id}/response.

  4. Используйте PUT /v1/queue/nano-banana-2/requests/{request_id}/cancel, когда необходимо остановить поставленную в очередь задачу.

Не заставляйте браузерный запрос ждать готового ресурса. Серверная задача может хранить идентификатор запроса, следовать подходящей политике опроса и показывать пользователю понятный статус выполнения или сбоя.

Проверьте спецификации и стоимость перед запуском в производство

Стоимость моделей генерации изображений может зависеть от модели, разрешения, настроек вывода и других параметров спецификации. В OdiRouter Model API pricing guidance говорится, что перед выполнением вызова следует проверить цену модели, спецификации параметров и ожидаемый результат. Включите эту проверку в процесс выпуска, когда меняются размер изображения, количество или режим.

Продолжите с OdiRouter

Используйте Nano Banana 2 API reference для ознакомления с актуальной таблицей параметров и структурой ответа. Nano Banana 2 model page — это место, где можно проверить доступность модели и продолжить интеграцию OdiRouter. Обращайтесь к этим официальным страницам, когда сведения меняются.

Источники

#API для генерации изображений#Nano Banana 2 API#OdiRouter