Используйте Seedance 2.0 image to video API по OdiRouter, если вам нужен асинхронный процесс создания видео на основе промпта и референсных медиафайлов. Официальный справочный номер OdiRouter содержит идентификатор модели, конечную точку очереди, заголовок аутентификации и URL-адреса задач, возвращаемые после запроса. Ознакомьтесь с этой страницей перед внедрением, поскольку поддерживаемые параметры могут измениться.
Что охватывает процесс OdiRouter
OdiRouter указывает модель как seedance-2-0. Создайте задачу с помощью POST /v1/queue/seedance-2-0 по адресу https://api.odirouter.ai/model. Отправляйте Authorization: Bearer YOUR_API_KEY с каждым запросом. Ответ на создание включает request_id и URL-адреса для проверки статуса, получения результата и отмены.
Это асинхронная очередь. Сохраните идентификатор запроса, опрашивайте URL статуса и получите результат, когда задача будет готова. Используйте официальную справочную документацию для получения актуальных полей запроса и допустимых значений.
Подготовьте референсное изображение
Для запроса преобразования изображения в видео добавьте изображение в content с типом image_url. В качестве документированного значения может выступать общедоступный URL-адрес изображения, URL-адрес данных в формате Base64 или идентификатор asset://. Обычно, когда файл слишком велик для практичного запроса в формате Base64, проще управлять общедоступным URL-адресом или подготовленным ресурсом.
Выберите роль изображения для данной работы. Используйте first_frame для одного начального изображения. Используйте first_frame с last_frame, когда на обоих концах необходимы фиксированные изображения. Используйте reference_image для процесса с референсным изображением. В официальной справочной документации эти сценарии считаются взаимоисключающими, поэтому отправляйте запрос одной согласованной структуры.
Создать задачу в очереди
В этом минимальном запросе остаются видимыми идентификатор модели и путь OdiRouter. Замените URL-адрес медиафайла, промпт и заполнитель API-ключа в вашем приложении. Храните конфиденциальные ключи на сервере, а не в коде браузера.
curl --request POST 'https://api.odirouter.ai/model/v1/queue/seedance-2-0' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"content": [
{"type": "text", "text": "A slow camera move through a sunlit studio."},
{"type": "image_url", "image_url": {"url": "https://example.com/reference.png"}, "role": "first_frame"}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5
}'В примере используются текстовый промпт и одно изображение начального кадра. Он показывает структуру запроса. Он не гарантирует качество результата, цену, длительность или доступность.
Выберите входные данные и настройки вывода
В официальной справочной документации Seedance 2.0 описаны типы контента: текст, изображения, видео и аудио. Она также охватывает сценарии использования первого кадра, первого и последнего кадров, а также эталонного изображения. Сосредоточьте промпты на сцене, предполагаемом движении и наиболее важных визуальных деталях. Перед отправкой запросов в продакшен проверьте актуальные ограничения для промптов и медиафайлов.
Документированные настройки вывода включают resolution, ratio и duration. На странице указаны коды разрешения 480p и 720p. В списке также указаны 1080p и 4k. Среди перечисленных вариантов соотношения сторон — 16:9, 9:16 и adaptive. Выберите параметры для целевой поверхности, затем подтвердите текущий допустимый диапазон в официальном справочнике, вместо того чтобы жестко задавать предположения.
Проверяйте статус и получайте результат
После создания задачи используйте возвращённый URL статуса для проверки хода выполнения. Документированный маршрут состояния: GET /v1/queue/seedance-2-0/requests/{request_id}/status. Когда задача завершится, используйте возвращённый URL ответа, чтобы получить результат. В той же справочной документации описан маршрут отмены для ожидающей задачи.
Рассматривайте идентификатор запроса как запись приложения. Сохраняйте состояние задачи, наглядно отображайте ошибки и определите поведение повторных попыток опроса в своей интеграции. Это даёт вашему продукту понятный способ обрабатывать асинхронный вызов модели.
Проверьте перед запуском в продакшен
OdiRouter публикует актуальную Seedance 2.0 model reference и documentation introduction для аутентификации, идентификаторов моделей и первых запросов. Перед развёртыванием ознакомьтесь с текущей записью модели и каталогом моделей OdiRouter. Используйте эту проверку, чтобы подтвердить текущую доступность, поля запроса и цены, зависящие от учётной записи.