Skip to main content
POST
Wan 2.7 비디오 편집

소개

Gravitex 게이트웨이를 통해 Alibaba Cloud Bailian wan2.7-videoedit 모델을 호출하여 기존 비디오에 지시형 편집(인물 교체, 의상 변경, 장면 스타일 조정 등)을 수행합니다. 인터페이스는 비동기 방식입니다: 먼저 작업을 제출한 후 결과를 폴링합니다. {task_id}는 작업 생성 시 반환된 id입니다.
Wan 2.7 비디오 생성(T2V / I2V / R2V)과 통합 비디오 진입점을 공유하지만, 모델과 media 매개변수 의미가 다르므로 혼용하지 마세요.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxx
string
필수
application/json으로 고정
string
요청 추적 ID, 매 요청마다 고유 값 생성 권장

요청 매개변수

string
필수
wan2.7-videoedit로 고정
string
필수
비디오 편집 지시문
integer
출력 비디오 길이(초), 예시는 4
string
필수
Alibaba Cloud에 전달되는 원본 프롬프트, 최상위 prompt와 동일하게 유지 권장
array
필수
입력 미디어 배열, 최소 하나의 비디오 포함
string
필수
원본 비디오는 video; 참조 이미지는 reference_image(최대 4장)
string
필수
공개 접근 가능한 HTTP/HTTPS URL 또는 업스트림 요구사항에 맞는 임시 URL
string
720P 또는 1080P
boolean
프롬프트 지능형 재작성 활성화 여부
boolean
워터마크 추가 여부

요청 예제

최소 요청(입력 비디오만):
참조 이미지 추가: 동일한 media 배열에 참조 이미지를 추가할 수 있습니다. 프롬프트에서 「图 1」로 지칭할 수 있습니다. 최대 4장의 참조 이미지를 지원합니다.

작업 생성 응답

생성 성공 시 표준화된 비디오 작업 객체를 반환합니다(code/message/data 외부 래퍼 없음):
반환된 id를 저장하여 후속 조회에 사용하세요.

작업 조회

조회 응답에는 code/message/data 외부 래퍼가 있습니다:

상태 처리

클라이언트는 data.status를 플랫폼 표준 상태로 사용해야 합니다: 업스트림 상태는 data.metadata.output.task_status(예: PENDING, SUCCEEDED)에 있으며, 디버깅용으로만 사용하고 주 상태 판단 기준으로 사용하지 마세요. 폴링 간격 5~15초를 권장하며, 고빈도 폴링은 피하세요.

출력 비디오 URL

성공 시 data.video_url을 우선 읽고, data.url도 읽을 수 있습니다(현재 어댑터에서는 보통 동일). 출력 URL은 서명된 임시 주소이므로 영구 비즈니스 리소스 주소로 저장해서는 안 됩니다. 장기 보관이 필요하면 유효 기간 내에 다운로드하거나 자체 OSS로 전송하세요.

길이 및 과금

실측에서 duration: 4 요청 시 업스트림 usage는 다음과 같을 수 있습니다: 따라서 data.seconds = 88초 비디오가 생성되었다는 의미가 아닙니다. 입력과 출력의 합산 과금 길이입니다. Alibaba Cloud 공식 과금: 「입력 비디오 길이 + 출력 비디오 길이」로 과금; 입력 이미지는 과금되지 않습니다. 자세한 내용은 공식 과금 안내를 참조하세요.

일반적인 오류 해결

Python 최소 예제