Skip to main content
POST
Reference-to-video: create a video task that preserves subject features from reference images/videos
오른쪽의 Playground에서는 직접 디버깅할 수 있습니다: Bearer sk-your-api-keyAuthorization에 넣고, model / input.media / parameters를 채운 다음 요청을 보내십시오. 성공적으로 제출하면 task_id가 반환됩니다. 폴링 및 다운로드는 아래를 참조하십시오.
이 페이지는 wan2.7-r2v(reference-to-video)의 생성 엔드포인트입니다. 참조 이미지/비디오를 제공하면 모델이 대상(사람/동물/사물)과 장면 특징을 유지하면서, 단일 캐릭터 연기 또는 다중 캐릭터 상호작용을 생성합니다. 더 많은 참조 이미지가 필요하면(최대 9개), HappyHorse r2v를 고려해 보십시오. 전체 비동기 흐름은 Wan 개요를 참조하십시오.
  • 참조 자산 인용 규칙: prompt에서 “image 1 / image 2”는 reference_image를, “video 1 / video 2”는 reference_video를 가리키는 데 사용하며, media 배열과 같은 순서로 작성하십시오(이미지와 비디오는 각각 별도로 계산합니다). 이미지/비디오가 하나뿐이면 “the reference image” / “the reference video”라고 간단히 쓰면 됩니다.
  • 개수 제한: reference_image + reference_video 총합 ≤5; 최대 first_frame 1개입니다.
  • 생성 요청은 /wan/api/v1/...X-DashScope-Async: enable를 사용해 보내십시오; /v1/videos는 사용하지 마십시오.

코드 예시

매개변수 및 미디어 빠른 참조

media[]

응답 형식

상태 확인 및 다운로드

task_id를 받으면, mp4의 상태를 조회하고 다운로드하기 위해 다음 세 단계를 따르십시오.
  • 조회 GET /v1/tasks/{task_id} (Authorization 포함; 쿼리는 X-DashScope-Async 헤더가 필요하지 않습니다), 10초마다(3초 미만은 안 됨) statuscompleted가 될 때까지 반복하십시오. Reference-to-video는 보통 1~5분이 걸리므로, 대체 수단으로 20분의 클라이언트 타임아웃을 설정하십시오.
  • 상태 값: submitted(대기 중) / in_progress(생성 중; progress가 30%에서 멈춰 있는 것은 정상입니다) / completed(성공) / failed(error 확인).
  • 다운로드: 응답에서 result_url를 직접 GET 하며, 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-r2v
필수

Model ID; for reference-to-video use wan2.7-r2v (legacy versions wan2.6-r2v / wan2.6-r2v-flash)

사용 가능한 옵션:
wan2.7-r2v,
wan2.6-r2v,
wan2.6-r2v-flash
input
object
필수
parameters
object

응답

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

예시:

"..."