Seedream V4 API на OdiRouter использует документированную модель seedream-4.0 и асинхронную очередь. Создайте задачу, сохраните идентификатор запроса, проверьте её статус, а затем получите результат после завершения. Перед развёртыванием проверьте текущий Seedream 4.0 model reference, поскольку доступность моделей и ограничения могут измениться.
Подтвердите идентификатор модели и конечную точку очереди
OdiRouter указывает идентификатор модели как seedream-4.0. Базовый URL API модели — https://api.odirouter.ai/model, а для создания задачи используется POST /v1/queue/seedream-4.0. Объедините их в серверном запросе.
curl --request POST "https://api.odirouter.ai/model/v1/queue/seedream-4.0" \
--header "Authorization: Bearer $ODIROUTER_API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
"image": "https://www.gstatic.com/webp/gallery/1.jpg",
"sequential_image_generation": "disabled",
"stream": false,
"response_format": "url"
}'Передавайте ключ API OdiRouter в заголовке Authorization: Bearer и храните его в конфигурации переменных окружения на стороне сервера. OdiRouter OpenAI SDK guide также указывает не раскрывать ключи API в браузерных сборках.
Выберите допустимые значения запроса, изображения и размера
Поле prompt является обязательным. Справочник Seedream 4.0 поддерживает запросы на китайском и английском языках и рекомендует использовать не более 300 китайских символов или 600 английских слов.
В необязательное поле image можно ввести URL-адрес, данные Base64 или массив эталонных изображений. OdiRouter документирует до 13 эталонных изображений, а также ограничения по формату файлов, размеру, соотношению сторон и количеству пикселей.
Для указания размера выходных данных используйте 1K, 2K или 4K, либо задайте ширину и высоту в пикселях. При указании размеров в пикселях проверьте как документированный диапазон общего количества пикселей, так и диапазон соотношения сторон. Значение, соответствующее одному правилу, всё равно может не соответствовать другому.
Отслеживайте асинхронную задачу
Ответ на создание задачи включает request_id, а также URL-адреса для статуса, ответа и отмены. Сохраните идентификатор запроса вместе с записью о вашем задании. Создание задачи не означает, что изображение уже готово, поэтому опрашивайте возвращённый URL статуса.
После завершения задачи используйте её URL ответа, чтобы получить результат. Согласно справочнику модели response_format: "url", URL для скачивания сгенерированного изображения действителен в течение 24 hours. Загрузите или сохраните ресурс в соответствии с политикой вашего приложения.
Добавьте проверки для production-среды перед развёртыванием
Рассматривайте создание задачи, опрос статуса, отмену и получение результата как отдельные состояния приложения. Запишите идентификатор запроса, обработайте ошибки терминала и сообщите пользователям, что генерация выполняется асинхронно. Используйте OdiRouter getting-started guide для ознакомления, затем изучите актуальный каталог моделей изображений при сравнении маршрутов.
Протестируйте рабочий процесс до того, как он станет доступен пользователям: отправьте один допустимый запрос, проверьте статус, получите ответ и убедитесь, что ни один ключ API не попадает в браузер. Этого достаточно, чтобы превратить решение о выборе модели в контролируемый запрос на генерацию изображения.