Руководство по API Seedance 2.0 reference video

Редакция OdiRouter

Запрос Seedance 2.0 reference video объединяет текстовую инструкцию с видеовходом в API очереди. OdiRouter документирует этот ввод как video_url, а его роль — reference_video. Сформируйте задачу как понятный запрос, затем используйте возвращённые URL-адреса задачи, чтобы отслеживать её прохождение через очередь.

Начните с клипа, который можно проверить

Перед отправкой задачи убедитесь, что сервис может получить доступ к URL-адресу видео. Проверьте, имеете ли вы право использовать отснятый материал, можно ли идентифицировать людей в клипе и требуют ли логотипы, экраны или аудио дополнительной проверки. Эти проверки помогают наладить производственный процесс. Они не гарантируют конкретный результат.

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

Отправьте запрос Seedance 2.0

В документе OdiRouter конечная точка очереди Seedance 2.0 обозначена как https://api.odirouter.ai/model/v1/queue/seedance-2-0. Отправьте массив content с текстовым элементом для инструкции и элементом video_url, чей role имеет значение reference_video.

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": "Show a ceramic cup on a studio table. Preserve the subject and use the reference clip as the motion guide."
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://example.com/reference-clip.mp4"
        },
        "role": "reference_video"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'

В текущей документации Seedance 2.0 перечислены варианты разрешения 480p, 720p, 1080p и 4k. В ней указана целочисленная длительность от 4 до 15 секунд либо -1, если сервис выбирает длительность автоматически. Перед началом производственной работы проверьте Seedance 2.0 API reference, поскольку параметры модели могут меняться.

Следуйте в очередь

Ответ на отправку документирует request_id, status_url, response_url, cancel_url и queue_position. Сохраните идентификатор запроса вместе с записью о задаче. Проверяйте ход выполнения через URL-адрес статуса, получайте результат через URL-адрес ответа после завершения и сохраните URL-адрес отмены, если работу нужно остановить.

На практике такое разделение полезно. Вы создаёте запрос один раз, а затем отслеживаете задачу отдельно. Не допускайте попадания API-ключей в журналы, скриншоты, систему контроля версий и общие URL-адреса клипов.

Проверьте входные данные, прежде чем менять всё подряд

Если тест не соответствует задаче, начните с частей, которые можно проверить:

  • Убедитесь, что video_url доступен через API.

  • Убедитесь, что элемент использует точную роль reference_video.

  • Убедитесь, что resolution, ratio и duration работают с выбранным эндпоинтом Seedance 2.0.

  • Удалите противоречащие инструкции, прежде чем изменять несколько переменных одновременно.

  • Сравните возвращённые идентификатор запроса и запись о статусе с полезной нагрузкой, которую вы намеревались отправить.

Цель — получить запрос, который можно проверить. Это не обещание, что один клип точно воспроизведёт каждое движение. Узконаправленный тест помогает определить, произошло ли изменение из-за фрагмента текста, текстовой инструкции или параметра запроса.

Продолжите с OdiRouter

Ознакомьтесь с текущими вариантами видео в каталоге видеомоделей OdiRouter. Держите OdiRouter documentation под рукой при интеграции рабочего процесса очереди. OdiRouter — API и целевой сервис конвертации для этого руководства.

Источники

#Seedance 2.0 reference video#reference_video#Видео-API OdiRouter