Прежде чем добавлять Seedream 5.0 Pro API в дорожную карту или кодовую базу, убедитесь, что учётная запись может его вызывать.
Проверьте актуальную документацию OdiRouter, чтобы узнать о доступных маршрутах для изображений. В актуальной документации Seedream 5.0 Lite указан как модель для работы с изображениями. В ней не указан эндпоинт или идентификатор модели Seedream 5.0 Pro. Это означает, что маршрут Pro, его стоимость и поддерживаемые входные данные требуют подтверждения, прежде чем команда будет считать их установленными фактами.
Самая быстрая надёжная проверка — каталог моделей OdiRouter для API-ключа, который будет выполнять рабочую нагрузку. OdiRouter описывает этот эндпоинт как каталог моделей, доступных текущему ключу, с полями, включая идентификатор, имя, поставщика, категорию, модальности, функции и время создания. Для принятия решения о развёртывании это более надёжный источник, чем старая публикация или похожая метка модели.
Сначала проверьте каталог учётной записи
Запросите в каталоге модели для изображений, соответствующие Seedream, затем сохраните точный id, возвращённый для производственной учётной записи.
GET https://api.odirouter.ai/v1/models/catalog?keyword=seedream&category=image
Authorization: Bearer YOUR_API_KEYЕсли ответ содержит модель с обозначением Pro, проверьте соответствующую документацию, чтобы подтвердить маршрут, полезную нагрузку, формат ответа, ограничения и актуальные сведения о тарификации.
Используйте соответствующую страницу OdiRouter в качестве источника, поддерживаемого владельцем продукта. Если модель не возвращается, используйте доступную модель, указанную в документации, или дождитесь, пока модель станет доступна. Фамилия не является допустимым идентификатором модели.
Включите эту проверку в контрольный список релиза. Доступность каталога может различаться в зависимости от учетной записи и может меняться по мере добавления, удаления или включения маршрутов.
Следуйте документированному жизненному циклу задач.
Seedream 5.0 Lite — документированный маршрут для изображений.
Его точный идентификатор модели — seedream-5.0-lite.
Поток обработки изображений OdiRouter является асинхронным:
Создайте задачу с помощью
POST /v1/queue/seedream-5.0-lite.Сохраните возвращённый
request_id.Храните
status_urlвместе с записью задачи.Храните
response_urlвместе с записью задачи.Опрашивайте URL статуса, пока задача не достигнет конечного состояния.
Получайте результат по URL ответа или отменяйте работу, которая приложению больше не нужна.
Базовый URL на странице модели — https://api.odirouter.ai/model. Сохраняйте URL-адреса, возвращаемые для задачи, вместо того чтобы формировать пути в других частях приложения. Это позволяет сохранить связь записи о запросе с ответом сервера.
POST https://api.odirouter.ai/model/v1/queue/seedream-5.0-lite
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
{
"prompt": "A studio product image with soft daylight",
"image": "https://example.com/reference.png",
"sequential_image_generation": "disabled",
"stream": false,
"size": "2K"
}Приведённая выше полезная нагрузка предназначена для документированного маршрута Lite. Она не показывает, что принимает непроверенный маршрут Pro.
Определите, что следует проверять в запросе на генерацию изображения
Справочник Lite описывает генерацию текста в изображение, изображения в изображение, генерацию с несколькими референсами, последовательную генерацию, потоковую выдачу, вывод в PNG или JPEG и дополнительный веб-поиск. Он принимает URL изображения или данные изображения в Base64 и документирует до 14 референсных изображений. На той же странице документированы поддерживаемые форматы изображений и настройки размера.
Для каждого запроса сохраняйте сведения, которые помогут кому-либо впоследствии диагностировать результат:
Идентификатор модели OdiRouter и маршрут.
Версию промпта и количество референсных изображений.
Запрошенный размер, формат вывода, настройку потоковой выдачи и настройку последовательной генерации.
request_id, состояние терминала, прошедшее время и место получения результата.Четко определенная категория ошибки: недопустимые входные данные, ответ поставщика, истечение времени ожидания, отмена или отклонение приложения.
Не записывайте в журнал постоянный URL изображения, если он раскрывает клиентский актив. Если это разрешено вашей политикой конфиденциальности, сохраняйте безопасную внутреннюю ссылку на актив.
Превратите доступность модели в проверку развёртывания
Названия моделей становятся надёжнее, когда процесс выпуска их проверяет. Перед включением маршрута изображения используйте этот короткий шлюз:
Проверить | Что проверить |
|---|---|
Каталог | API-ключ производства позволяет увидеть точный идентификатор модели. |
Документация | OdiRouter публикует конечную точку и схему запроса для этого идентификатора. |
Тестовая задача | Несекретный тестовый запрос завершается, и приложение может обработать его результат. |
Рабочий процесс | Сервис сохраняет идентификатор запроса, обрабатывает конечные сбои и имеет решение о повторной попытке или резервном варианте. |
Проверка стоимости | Команда проверяет текущую тарифную структуру OdiRouter для этой модели и режима запроса. |
Для запроса Seedream 5.0 Pro API начните со строк каталога и документации. У семейства моделей может быть несколько публичных названий, однако коду нужен точный идентификатор, доступный учётной записи, которая будет отправлять запросы.
Следующий шаг в OdiRouter
Используйте model catalog documentation, чтобы проверить текущий список, видимый учётной записи.
Просмотрите OdiRouter models catalog, чтобы сравнить маршруты.
Откройте Seedream 5.0 Lite API reference, если этот документированный маршрут подходит для задачи.
Если позже появится маршрут с маркировкой Pro, выполните ту же проверку на его точной странице OdiRouter. Полезным результатом является воспроизводимая запись об идентификаторе модели, маршруте, запросе и результате, а не предположение, основанное на названии модели.