Skip to main content
POST
Video edit: create an edit task from a video + reference images + instruction
오른쪽의 Playground에서는 직접 디버깅할 수 있습니다: Bearer sk-your-api-keyAuthorization에 넣고, model / input.media / parameters를 채운 다음 요청을 전송하십시오. 성공적으로 제출되면 task_id가 반환됩니다. 폴링과 다운로드는 아래를 참조하십시오.
이 페이지는 wan2.7-videoedit(동영상 편집)의 생성 엔드포인트입니다. 동영상 + 1~5개의 참조 이미지 + 자연어 편집 지시문을 제공하여 의상이나 배경을 바꾸는 등 동영상 요소를 편집할 수 있습니다. 모델 이름에는 하이픈이 없습니다(videoedit). 전체 비동기 흐름은 Wan 개요를 참조하십시오.
  • input.media에는 video(편집 중인 동영상)와 최소 하나의 reference_image(참조 자산, ≤5)가 모두 포함되어야 합니다.
  • 모델 이름은 wan2.7-videoedit(하이픈 없음)이며, 하이픈이 있는 HappyHorse의 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초 미만은 아님) statuscompleted가 될 때까지 반복합니다.
  • 상태 값: submitted(대기 중) / in_progress(생성 중; progress가 30%에 머무는 경우가 많아도 정상입니다) / completed(성공) / failed(error를 확인하십시오).
  • 다운로드: 응답에서 result_url를 직접 GET하십시오. Authorization 헤더는 사용하지 마십시오(이는 OSS 서명된 직접 링크이며, Auth를 보내면 403이 반환됩니다). result_url는 기본적으로 24시간 후 만료되므로, 즉시 저장하십시오.
위 내용은 이미 task_id가 있는 경우를 위한 빠른 확인/다운로드 경로입니다. timeout fallback이 포함된 전체 polling loop와 Python client는 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

예시:

"..."