Seedance 1.5 Pro API Руководство по видеозадачам

Редакция OdiRouter

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: false

generate_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

Опрашивайте конечную точку статуса через контролируемые интервалы. Ответ следует получать только после того, как задание успешно завершится. Если пользователь отменяет задание или приложение больше в нем не нуждается, вызовите конечную точку отмены и прекратите опрос.

Перед отправкой проверьте правильность запроса.

  1. Сопоставьте массив content с одним из поддерживаемых режимов: только текст, первый кадр, первый и последний кадры или черновое задание.

  2. Проверьте каждый URL-адрес изображения, размер файла, размеры, формат, соотношение сторон и роль кадра.

  3. Сравните продолжительность с допустимыми значениями, указанными выше.

  4. Когда включён режим черновика, используйте совместимое с ним разрешение и отключите описанные выше неподдерживаемые параметры.

  5. Сохраните возвращённые URL-адреса задания и идентификатор запроса до запуска цикла опроса.

  6. Храните ключ API на сервере. Не размещайте его в коде браузера, журналах или промпте для видео.

Эта локальная проверка выявляет недопустимые комбинации до того, как запрос попадёт в очередь.

Проверьте текущую стоимость перед развёртыванием

Продолжительность, разрешение, аудио и выбор сервиса влияют на нагрузку. Проверьте актуальную страницу с ценами, прежде чем закладывать фиксированный бюджет в код или документацию: https://odirouter.ai/pricing

Начните с короткого запроса, представляющего предполагаемый режим ввода. Подтвердите результат и полный жизненный цикл задания, затем увеличьте продолжительность или разрешение, если это необходимо для приложения.

Держите справочник по API модели рядом с реализацией: https://odirouter.ai/docs/api-reference/model-api/bytedance/seedance-1-5-pro

Создайте учётную запись и ключ API через OdiRouter, когда запрос будет готов: https://odirouter.ai/

Официальные источники

#API преобразования изображения в видео#API преобразования текста в видео#OdiRouter#Seedance 1.5 Pro API