Seedance 2.0 API позволяет вашему приложению отправить задачу на генерацию видео через OdiRouter, а затем отслеживать её до получения результата. В коде OdiRouter указан идентификатор модели seedance-2-0 и способ отправки данных https://api.odirouter.ai/model/v1/queue/seedance-2-0. Начните с небольшого запроса, который можно проверить, прежде чем включать его в продукт.
Это руководство основано на опубликованном контракте API. Оно охватывает промпт вместе с эталонным видео, ответ очереди и короткий цикл проверки. Оно не гарантирует конкретный визуальный результат, фиксированное время ожидания в очереди или цену. Ознакомьтесь с каталогом моделей OdiRouter и pricing page, прежде чем запускать рабочий процесс в продакшен.
Что принимает конечная точка Seedance 2.0
В публичной документации по моделям OdiRouter указана seedance-2-0 как видеомодель, принимающая текстовые, графические, видео- и аудиовходные данные. Конечная точка очереди принимает массив content. Можно выполнить тест только с текстом; в документации также показаны входные данные с эталонными медиафайлами. Для эталонного видео отправьте элемент содержимого video_url с ролью reference_video.
Параметр duration использует целые секунды. Опубликованный диапазон — от 4 до 15 либо -1, если модель должна автоматически выбрать длительность. Указанное значение по умолчанию — 5. Длительность влияет на стоимость, поэтому перед её увеличением используйте короткий и конкретный тест. Конечная точка также принимает resolution и ratio.
Подготовьте небольшой первый тест
Первую задачу следует сузить до того, чтобы ее можно было проверить. Выберите одну сцену, одно основное действие и один эталонный клип, который вам разрешено отправить. Запишите текст запроса, запрошенное соотношение, продолжительность, идентификатор модели и идентификатор возвращенного запроса. У вас будет базовый уровень, который будет определен при последующем изменении выходных данных.
Для эталонного видео убедитесь, что URL-адрес доступен для сервиса и что файл соответствует текущим требованиям модели. OdiRouter перечисляет mp4 и mov входные данные, диапазон от 2 до 15 секунд для каждого входного видео, до трёх эталонных видео и суммарную продолжительность эталонных видео не более 15 секунд. Перед реализацией запроса ещё раз проверьте документацию.
Отправьте задачу Seedance 2.0
Установите YOUR_API_KEY в своём окружении. В приведённом ниже примере используется общедоступный URL-заполнитель. Замените его эталонным материалом, на использование которого у вас есть разрешение, либо remove элемент эталонного медиафайла для теста только с текстом.
export API_KEY="YOUR_API_KEY"
curl --request POST \
"https://api.odirouter.ai/model/v1/queue/seedance-2-0" \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data-raw '{
"content": [
{
"type": "text",
"text": "A slow product shot of a ceramic mug on a wooden desk, soft window light, one continuous camera move."
},
{
"type": "video_url",
"video_url": {
"url": "https://example.com/reference.mp4"
},
"role": "reference_video"
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'Структура запроса соответствует документации OdiRouter Seedance 2.0. Не добавляйте поле только потому, что его принимает другая видеомодель. Модели могут различаться поддерживаемыми входными данными и ограничениями.
Сохраните ответ задачи и опрашивайте её статус
Ответ на отправку содержит request_id, response_url, status_url, cancel_url и queue_position. Эти значения описывают состояние задачи. Это не готовое видео. Сохраните идентификатор запроса и возвращённые URL-адреса вместе с отправленными параметрами.
Опрашивайте возвращённый status_url с ограниченным интервалом, подходящим для вашего приложения. Если задача сообщает о конечной ошибке, сохраните идентификатор запроса и сведения из ответа для диагностики. Если пользователь отменяет работу, используйте возвращённый cancel_url, а не пытайтесь угадать путь. Прочитайте response_url после того, как задача перейдёт в состояние завершения.
curl --location "STATUS_URL_FROM_THE_SUBMISSION_RESPONSE" \
--header "Authorization: Bearer YOUR_API_KEY"
curl --location "RESPONSE_URL_FROM_THE_SUBMISSION_RESPONSE" \
--header "Authorization: Bearer YOUR_API_KEY"Используйте URL-адреса из ответа API. Они содержат идентификатор задачи, поэтому замена их на созданный вручную путь затруднит отслеживание сбоя.
Рассматривайте по одной переменной за раз.
Используйте один и тот же контрольный список проверки для каждой завершённой задачи. Проверьте, соответствует ли результат запрошенной сцене и основному действию. Затем проверьте, используется ли эталонный носитель должным образом, соответствует ли темп повествования целевому объекту и работает ли формат в целевом редакторе или приложении.
Если тест требует доработки, измените одну значимую переменную. Можно сократить промпт, скорректировать запрошенное соотношение сторон, заменить слабый эталонный материал или изменить продолжительность в пределах опубликованного диапазона. Остальную часть запроса оставьте без изменений. Это привычка проектирования экспериментов, а не обещание того, что параметр гарантирует качество.
Move от теста к интеграции
После завершения небольшого теста внедрите тот же жизненный цикл в свой сервис: отправьте задачу, сохраните её метаданные, опрашивайте статус, получите ответ и сохраните ссылку на созданный ресурс. Храните ключи API на сервере и записывайте в журнал идентификатор запроса, а не ключ. OdiRouter getting-started guide охватывает аутентификацию и более широкий рабочий процесс API.
Перед выпуском вновь проверьте каталог видеомоделей OdiRouter и current pricing. Доступность, ограничения на входные данные и стоимость могут измениться. Проверка каталога безопаснее, чем закладывать предположения в интеграцию.
Источники
OdiRouter documentation: идентификаторы моделей, шаблоны очередей, конечная точка Seedance 2.0, документированные входные данные, поля ответа задачи и примечания к параметрам.
Видеомодели OdiRouter: актуальный поиск моделей.
OdiRouter pricing: актуальная информация о стоимости.