Seedance 1.5 Pro API выполняется как асинхронная видеозадача. OdiRouter предоставляет доступ к конечной точке. Запрос может начинаться с текста, одного изображения первого кадра или пары изображений первого и последнего кадров. Модель может создавать аудио, синхронизированное с видео. OdiRouter возвращает отдельные URL-адреса для проверки статуса, получения результата и отмены задачи.
Проверьте текущую доступность на странице модели OdiRouter: https://odirouter.ai/models/seedance-1-5-pro
Актуальную схему запроса и ограничения смотрите в справочнике API модели: https://odirouter.ai/docs/api-reference/model-api/bytedance/seedance-1-5-pro
Сначала выберите режим ввода
Seedance 1.5 Pro поддерживает три стандартных варианта ввода:
Для преобразования текста в видео отправьте объект текстового содержимого с настройками генерации.
Для преобразования изображения первого кадра в видео отправьте текст и один объект изображения. Его роль можно не указывать или задать как
first_frame.Для генерации с первым и последним кадрами отправьте текст и два объекта изображения. Установите для них роли
first_frameиlast_frame.
API также принимает входные данные draft_task, если черновик нужно преобразовать в готовое видео. Эта задача может повторно использовать исходные модель, текст, изображения, настройку аудио, seed, соотношение сторон, длительность и настройку камеры.
Промпты можно писать на китайском или английском языке. Текст должен содержать не более 500 символов. Изображение может быть предоставлено через доступный URL-адрес или URL-адрес данных Base64.
Принимаемые форматы изображений:
JPEG PNG WebP BMP TIFF GIF HEIC HEIFРазмер каждого изображения должен быть меньше 30 MB. Его ширина и высота должны быть не менее 300 пикселей. Ни один из параметров не может превышать 6000 пикселей. Соотношение ширины к высоте должно быть не менее 0.4. Оно не может превышать 2.5.
Создайте видеозадачу
Базовый URL: https://api.odirouter.ai/model. Создайте задачу с помощью POST /v1/queue/seedance-1-5-pro. Передавайте ключ API в заголовке Authorization. Используйте ключ, выданный OdiRouter.
curl --request POST \
'https://api.odirouter.ai/model/v1/queue/seedance-1-5-pro' \
--header 'Authorization: Bearer YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data-raw '{
"content": [
{
"type": "text",
"text": "A red paper kite rises above a quiet beach at sunrise."
}
],
"resolution": "720p",
"ratio": "16:9",
"duration": 5,
"generate_audio": true
}'Ответ на создание содержит следующие поля:
request_id
response_url
status_url
cancel_url
queue_positionСохраните идентификатор запроса и возвращённые URL-адреса вместе с записью задания. Они служат идентификаторами для всех последующих операций.
Выберите настройки генерации
Текущие допустимые значения и значения по умолчанию:
generate_audio:
default: true
resolution:
allowed: [480p, 720p, 1080p]
default: 720p
ratio:
allowed: [16:9, 4:3, 1:1, 3:4, 9:16, 21:9, adaptive]
default: adaptive
duration:
allowed: [4..12, -1]
default: 5
draft:
default: false
return_last_frame:
default: false
service_tier:
allowed: [default, flex]
default: default
execution_expires_after:
allowed: [3600..259200]
default: 172800
seed:
allowed: [-1..2^32-1]
default: -1
camera_fixed:
default: false
watermark:
default: falsegenerate_audio управляет синхронизированными голосом, звуковыми эффектами и фоновой музыкой. Отключите его, если результат должен быть беззвучным.
В режиме черновика используется указанное выше разрешение предварительного просмотра. Он не поддерживает возврат последнего кадра или офлайн-инференс.
return_last_frame полезен, когда финальный кадр станет первым кадром другой генерации.
service_tier переключает между онлайн- и офлайн-инференсом.
camera_fixed фиксирует камеру при включении.
watermark определяет, содержит ли результат водяной знак.
Помещайте произносимые реплики в двойные кавычки в промпте. Документация рекомендует этот формат, когда сгенерированное аудио должно синхронизировать речь с видео.
Проверьте статус, получите результат или отмените задание
Генерация видео выполняется как задание в очереди. Используйте идентификатор запроса из ответа на создание со следующими операциями:
GET /v1/queue/seedance-1-5-pro/requests/{request_id}/status
GET /v1/queue/seedance-1-5-pro/requests/{request_id}/response
PUT /v1/queue/seedance-1-5-pro/requests/{request_id}/cancelОпрашивайте конечную точку статуса через контролируемые интервалы. Ответ следует получать только после того, как задание успешно завершится. Если пользователь отменяет задание или приложение больше в нем не нуждается, вызовите конечную точку отмены и прекратите опрос.
Перед отправкой проверьте правильность запроса.
Сопоставьте массив content с одним из поддерживаемых режимов: только текст, первый кадр, первый и последний кадры или черновое задание.
Проверьте каждый URL-адрес изображения, размер файла, размеры, формат, соотношение сторон и роль кадра.
Сравните продолжительность с допустимыми значениями, указанными выше.
Когда включён режим черновика, используйте совместимое с ним разрешение и отключите описанные выше неподдерживаемые параметры.
Сохраните возвращённые URL-адреса задания и идентификатор запроса до запуска цикла опроса.
Храните ключ API на сервере. Не размещайте его в коде браузера, журналах или промпте для видео.
Эта локальная проверка выявляет недопустимые комбинации до того, как запрос попадёт в очередь.
Проверьте текущую стоимость перед развёртыванием
Продолжительность, разрешение, аудио и выбор сервиса влияют на нагрузку. Проверьте актуальную страницу с ценами, прежде чем закладывать фиксированный бюджет в код или документацию: https://odirouter.ai/pricing
Начните с короткого запроса, представляющего предполагаемый режим ввода. Подтвердите результат и полный жизненный цикл задания, затем увеличьте продолжительность или разрешение, если это необходимо для приложения.
Держите справочник по API модели рядом с реализацией: https://odirouter.ai/docs/api-reference/model-api/bytedance/seedance-1-5-pro
Создайте учётную запись и ключ API через OdiRouter, когда запрос будет готов: https://odirouter.ai/
Официальные источники
Страница модели Seedance 1.5 Pro: https://odirouter.ai/models/seedance-1-5-pro
Справочник Seedance 1.5 Pro API: https://odirouter.ai/docs/api-reference/model-api/bytedance/seedance-1-5-pro
Цены OdiRouter: https://odirouter.ai/pricing
Введение в OdiRouter: https://odirouter.ai/docs/get-started/introduction