Seedance 2.0 API редактирования видео

Редакция OdiRouter

API для редактирования видео Seedance 2.0 использует существующий клип в качестве эталонного материала, а не начинает работу только с подсказки.

В текущем каталоге указана модель OdiRouter.

Откройте Seedance 2.0 model page, чтобы просмотреть эту запись.

Официальный API reference охватывает мультимодальные эталонные входные данные, редактирование видео и расширение видео. В этом руководстве используются его структура запросов и жизненный цикл задач.

Используйте эталонное видео

Документированный запрос Seedance 2.0 может отправлять список элементов.

Первое поле массива в приведённом ниже запросе содержит эти элементы.

Укажите предполагаемый результат в текстовом элементе.

Добавьте исходный материал в качестве видеоэлемента с ролью reference_video.

В справочнике API тип видеовхода обозначен как video_url.

Эталонный клип передаёт контекст движения, кадрирования или объекта. Используйте текстовый элемент для описания изменения. Если редактирование зависит от действия в клипе, назовите это действие, а не полагайтесь на общее указание.

В текущей документации перечислены следующие ограничения для исходного видео:

  • Для одного видео можно использовать mp4 или mov.

  • Каждый входной видеопоток может длиться от 2 до 15 секунд.

  • Запрос может включать до 3 эталонных видео с общей продолжительностью 15 секунд.

  • Поддерживаемые входные разрешения включают 480p и 720p.

  • В том же списке указаны 1080p и 4k.

  • Соотношение ширины к высоте может находиться в диапазоне от 0.4 до 2.5.

Перед использованием в производственной среде проверьте Seedance 2.0 API reference, поскольку сведения о модели могут измениться.

Отправьте запрос в очередь

OdiRouter документирует конечную точку очереди для seedance-2-0.

Этот пример соответствует документированной структуре запроса. Замените инструкцию и 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' \
  --location \
  --data-raw '{
    "content": [
      {
        "type": "text",
        "text": "Adjust the lighting and keep the action from reference_video."
      },
      {
        "type": "video_url",
        "video_url": {
          "url": "https://interactive-examples.mdn.mozilla.net/media/cc0-videos/flower.mp4"
        },
        "role": "reference_video"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5
  }'

Текстовый элемент описывает результат.

Объект video_url содержит эталонный клип.

Официальный пример включает элементы управления resolution и ratio.

Он также включает duration.

Перед отправкой проверьте собственный входной URL-адрес и значения.

Выполните задание после его отправки.

В задокументированном ответе содержатся поля управления задачами:

  • request_id идентифицирует запрос.

  • response_url — это документированный URL-адрес результата.

  • status_url — это документированный URL-адрес состояния.

  • cancel_url — это документированный URL-адрес отмены.

Сохраните идентификатор запроса вместе с записью задания. Используйте возвращённые URL-адреса для следующего этапа задачи, а не ожидайте готовое видео в ответе на отправку.

Отправьте запрос, при необходимости проверяйте статус и получайте результат по документированному URL-адресу ответа, когда задача будет готова. Храните сведения об ошибках и повторных попытках рядом с идентификатором запроса, чтобы пользователи могли понять, какая задача требует внимания.

Проверьте текущий контракт OdiRouter

Страница модели и справочник API являются актуальными источниками информации о Seedance 2.0 в OdiRouter. Перед выпуском проверьте актуальные сведения о модели, настройки учётной записи, схему запроса и ограничения, особенно при переходе от одного тестового клипа к производственному рабочему процессу.

Откройте Seedance 2.0 on OdiRouter, чтобы просмотреть актуальную запись модели.

Используйте Seedance 2.0 API reference для полей запроса и URL-адресов задач.

Источники

#API для редактирования видео Seedance#API для эталонных видео