Nano Banana Gemini Доступ к API изображений использует документированную очередь моделей OdiRouter. Создайте задачу nano-banana с помощью ключа API OdiRouter, затем используйте возвращённые URL-адреса для проверки статуса, получения результата или отмены задачи. Перед сборкой откройте текущие файлы Nano Banana model page и Nano Banana API reference. Доступность моделей и условия использования учетных записей могут меняться.
Что документирует OdiRouter для Nano Banana
OdiRouter описывает Nano Banana как модель изображений на основе Gemini для генерации, редактирования и композиции из нескольких изображений. Её документированный базовый URL-адрес — https://api.odirouter.ai/model, а новая задача отправляется в POST /v1/queue/nano-banana.
В справочной документации показан асинхронный рабочий процесс:
Создайте задачу с помощью
POST /v1/queue/nano-banana.Проверяйте ход выполнения с помощью
GET /v1/queue/nano-banana/requests/{request_id}/status.Получите завершённый результат с помощью
GET /v1/queue/nano-banana/requests/{request_id}/response.Отмените задачу с помощью
PUT /v1/queue/nano-banana/requests/{request_id}/cancel.
request_id, а также возвращаемые URL-адреса статуса, ответа и отмены связывают поставленную в очередь задачу с вашим приложением. Время завершения не фиксировано, поэтому при интеграции ориентируйтесь на конечные точки статуса и ответа.
Создайте задачу в очереди
Войдите в OdiRouter и используйте ключ API для своей учётной записи. Храните ключ в хранилище секретных данных на стороне сервера или в переменной окружения. Этому не место в коде браузера, общедоступном репозитории или клиентском приложении.
В этом примере используются поля из текущей справочной информации OdiRouter. YOUR_API_KEY — это заполнитель, а не учётные данные.
curl --location "https://api.odirouter.ai/model/v1/queue/nano-banana" \
--header "Authorization: Bearer YOUR_API_KEY" \
--header "Content-Type: application/json" \
--data '{
"prompt": "A red apple on a white table, clean studio lighting, simple background.",
"image_urls": [
"https://example.com/reference-image.webp"
]
}'Ответ содержит request_id и URL-адреса для проверки статуса, получения ответа и отмены. Сохраните идентификатор запроса вместе с собственной записью о задаче. После этого процесс повторных попыток, обработчик вебхуков или процесс опроса сможет отслеживать нужную задачу без повторного построения маршрута.
Выбирайте входные данные, соответствующие документированному API
Обязательный параметр prompt принимает от 1 до 2500 символов. Для справочных материалов или контекста редактирования image_urls принимает до трёх URL-адресов изображений. В справочнике API также перечислены aspect_ratio, image_size, resolution и response_modalities.
Для aspect_ratio документированы значения 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9 и 21:9. Документированное значение image_size — 1K. Перечисленные значения resolution: 1024x1024, 832x1248, 1248x832, 864x1184, 1184x864, 896x1152, 1152x896, 768x1344, 1344x768 и 1536x672.
response_modalities определяет, возвращает ли модель текст и изображения. В справочнике ["Text", "Image"] указано как значение по умолчанию, а ["Image"] — если нужны ответы только с изображениями. Перед реализацией текущего контракта и примеров проверьте Nano Banana API reference.
Перед запуском проверьте детали для рабочей среды
Конечная точка не определяет, готов ли процесс обработки изображений для клиентов. Запустите небольшой набор тестов с вашими реальными стилями промптов и разрешёнными справочными изображениями. Проверьте композицию, следование инструкциям, визуальную согласованность, детали продукта и любой текст, который должен присутствовать на изображении.
Проверьте текущие права доступа к учётной записи и цены в OdiRouter. Подтвердите, что у вас есть права на каждое входное изображение, и пересмотрите собственные требования к использованию результатов и обработке данных. Установите лимит бюджета, запишите идентификаторы задач и определите, как ваше приложение будет обрабатывать состояния «в очереди», «сбой», «отмена» и «завершение». Это проверки реализации, а не утверждения о неизменной политике модели.
Продолжите работу с актуальной документацией OdiRouter
Откройте Nano Banana model page, чтобы ознакомиться с актуальным списком моделей, затем используйте Nano Banana API reference для полного контракта запроса и ответа. Это позволяет привязать интеграцию к первичной документации, а не к скопированному маршруту или устаревшему примеру.