Skip to main content
POST
Video edit: create an edit task from a video + reference images + instruction
Песочница справа позволяет отлаживать напрямую: поместите Bearer sk-your-api-key в Authorization, заполните model / input.media / parameters и отправьте запрос. Успешная отправка возвращает task_id; ниже см. сведения о polling и загрузке.
Эта страница — эндпоинт создания для wan2.7-videoedit (редактирование видео): передайте видео + 1-5 reference images + инструкцию редактирования на естественном языке, чтобы изменить элементы видео, например заменить одежду или фон. Обратите внимание: у названия модели нет дефиса (videoedit). Полный асинхронный процесс см. в Обзор Wan.
  • input.media должен содержать и video (редактируемое видео), и как минимум одно reference_image (референсный объект, ≤5).
  • Название модели — wan2.7-videoedit (без дефиса), оно отличается от HappyHorse’s happyhorse-1.0-video-edit (с дефисами), так что не путайте их.
  • Запросы на создание отправляются в /wan/api/v1/... с X-DashScope-Async: enable; не используйте /v1/videos.

Примеры кода

Краткая справка по параметрам и медиа

Значения media[]

Длительность результата редактирования видео соответствует входному видео, а не параметру duration, поэтому эта возможность обычно не передает duration.

Формат ответа

Проверка статуса и скачивание

Когда у вас есть task_id, выполните следующие три шага, чтобы опрашивать статус и скачать mp4:
  • Опрос GET /v1/tasks/{task_id}Authorization; запросу не нужен заголовок X-DashScope-Async) каждые 5-10 секунд (не < 3 секунд), пока status не станет completed.
  • Значения статуса: submitted (в очереди) / in_progress (генерируется; если progress часто остается на 30%, это нормально) / completed (успешно) / failed (проверьте error).
  • Скачивание: получите result_url напрямую из ответа, без заголовка Authorization (это подписанная прямая ссылка OSS — при отправке Auth возвращается 403); result_url по умолчанию истекает через 24 часа, поэтому сохраните ее сразу.
Выше приведен быстрый путь проверки/скачивания для случая «у вас уже есть task_id». Для полного цикла опроса (с запасным вариантом при тайм-ауте) и Python-клиента см. Обзор Wan · Поток асинхронного вызова.

Авторизации

Authorization
string
header
обязательно

The API Key obtained from the APIYI console

Заголовки

X-DashScope-Async
enum<string>
по умолчанию:enable
обязательно

Async processing switch; must be set to enable

Доступные опции:
enable

Тело

application/json
model
enum<string>
по умолчанию:wan2.7-videoedit
обязательно

Model ID, fixed wan2.7-videoedit (no hyphen)

Доступные опции:
wan2.7-videoedit
input
object
обязательно
parameters
object

Ответ

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

Пример:

"..."