Название Doubao API охватывает широкое семейство моделей ByteDance, но интеграция по-прежнему начинается с указания конкретной модели и формата запроса. OdiRouter в настоящее время предоставляет маршруты для видео Seedance и изображений Seedream через одну учётную запись и API-ключ. Это руководство посвящено этим проверенным маршрутам, жизненному циклу очереди и проверкам, которые стоит выполнить перед запуском в продакшен.
Что в настоящее время перечисляет OdiRouter
В публичной карте сайта моделей и документации OdiRouter перечислено несколько творческих моделей ByteDance. Для видео текущий набор включает Seedance 1.5 Pro, Seedance 2.0, Seedance 2.0 Fast и Seedance 2.0 Mini. Для изображений он включает Seedream 4.0, Seedream 4.5 и Seedream 5.0 Lite.
Этот список намеренно уже, чем каталог на справочной странице. Доступность и цены могут меняться. Перед развёртыванием проверьте OdiRouter pricing page и актуальную страницу модели.
Используйте Seedance, если результатом является видео
Seedance — подходящее семейство для вывода видео. В документации OdiRouter указано, что Seedance 2.0 поддерживает генерацию видео на основе мультимодальных референсов. Та же документация охватывает редактирование, расширение, согласованность персонажей и более полный контроль над готовой последовательностью.
Отдельные маршруты указаны для вариантов Seedance, 2.0, Fast и Mini. Выбирайте маршрут только после проверки текущих характеристик модели и входных данных, необходимых для вашего рабочего процесса. Seedance 2.0 model page и API reference — лучшие варианты для начала.
Используйте Seedream, когда результатом является изображение.
Seedream предназначен для генерации и редактирования изображений. В документации Seedream 4.5 описаны улучшенная согласованность, детализация и творческий контроль. Другие маршруты для изображений перечислены в текущем каталоге.
Seedream 4.5 API reference отображает запрос в очереди с подсказкой, необязательной ссылкой на образ, элементами управления генерацией и размером выходного файла. Перед написанием кода ознакомьтесь с актуальной справкой, поскольку допустимые поля различаются в зависимости от модели.
Отправьте запрос через OdiRouter.
Создайте учётную запись OdiRouter, выпустите API-ключ и убедитесь, что выбранная вами модель доступна. OdiRouter использует аутентификацию Bearer. Храните ключ в серверном секрете или переменной окружения. Он никогда не должен появляться в коде браузера или публичном репозитории.
Этот пример соответствует документированной структуре очереди Seedance 2.0. Замените промпт и URL-адрес ссылки данными, которые вам разрешено обрабатывать.
curl --request POST 'https://api.odirouter.ai/model/v1/queue/seedance-2-0' \
--header "Authorization: Bearer ${ODIROUTER_API_KEY}" \
--header 'Content-Type: application/json' \
--data-raw '{
"content": [
{
"type": "text",
"text": "Create a five-second product video using the reference clip."
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/reference.mp4"
},
"role": "reference_video"
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'Тела запросов зависят от модели. Маршруты Seedream используют другую структуру, а для некоторых входных данных Seedance может потребоваться предварительно создать ресурсы через конечные точки ресурсов OdiRouter.
Сохраните URL-адреса задачи и отслеживайте результат.
Успешная постановка в очередь возвращает request_id вместе с response_url, status_url и cancel_url. Сохраните их вместе с записью о задаче. Опрашивайте указанный URL-адрес состояния с контролируемым интервалом, получайте готовый результат с URL-адреса ответа и оставляйте возможность отмены только для тех заданий, которые вашему приложению действительно необходимо остановить.
Принятый HTTP-запрос не означает, что генерация завершена. Ваш код всё равно должен обрабатывать задержки очереди, некорректные входные данные, ошибки модели, тайм-ауты и задачу, которая завершается без пригодного результата.
Краткий чек-лист для продакшена
Подтвердите идентификатор модели и поля запроса в актуальной документации OdiRouter.
Перед запуском большой пакетной обработки проверьте актуальные цены.
Проверьте URL-адреса ссылок, владельца файла, тип содержимого и размер.
Не храните API-ключ в исходном коде.
Сразу сохраняйте идентификатор запроса и URL-адреса для последующих действий.
Установите ограничения для опроса, тайм-аутов, повторных попыток и отмены.
Логируйте коды статуса и ошибок, не записывая учётные данные или URL-адреса приватных медиафайлов.
Сделайте маршрут модели своим источником истины.
Одного названия провайдера недостаточно для выпуска интеграции. Вам нужны актуальный маршрут модели, аутентифицированный запрос и жизненный цикл задачи, который сможет отслеживать ваше приложение. OdiRouter предоставляет эти компоненты для моделей Seedance и Seedream, перечисленных в его текущем каталоге.
Начните с OdiRouter quick start, изучите актуальные pricing и держите открытой справку по API для конкретной модели во время разработки.