Skip to main content
POST
Reference-to-Video: create a video task with up to 9 reference images to preserve the subject
오른쪽의 플레이그라운드에서 직접 디버그할 수 있습니다: AuthorizationBearer sk-your-api-key을 입력하고, model / input.media / parameters를 설정한 다음 요청을 전송합니다. 제출이 성공하면 task_id가 반환됩니다. 아래에서 폴링과 다운로드를 확인하십시오.
이 페이지는 happyhorse-1.1-r2v(참조 기반 동영상)의 create 엔드포인트를 다룹니다: 참조 이미지를 제공하면 모델이 그 안의 피사체와 장면 특징을 보존합니다. HappyHorse-r2v는 최대 9개의 참조 이미지를 지원하여 다중 참조 시나리오에서 더 강한 피사체 일관성을 제공합니다. 전체 비동기 흐름은 HappyHorse 개요를 참조하십시오.
  • happyhorse-1.1-r2v는 최대 9개의 reference_image 항목을 지원합니다(Wan2.7-r2v의 합산 ≤5보다 많습니다).
  • input.media이 필요하며, 미디어 url는 GET으로 직접 가져올 수 있는 공개 https 링크여야 합니다.
  • create 요청은 /wan/api/v1/...X-DashScope-Async: enable을 사용해 전송해야 하며, /v1/videos를 사용하면 안 됩니다.

코드 예시

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

media[]

응답 형식

제출 후, GET /v1/tasks/{task_id}를 폴링하여 completed까지 기다린 다음, result_url에서 mp4를 다운로드합니다(Authorization 헤더 없이, 24시간 후 만료됩니다). 전체 폴링 루프는 HappyHorse 개요 · 비동기 호출 흐름에서 확인합니다.

인증

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>
기본값:happyhorse-1.1-r2v
필수

Model ID, fixed to happyhorse-1.1-r2v for Reference-to-Video

사용 가능한 옵션:
happyhorse-1.1-r2v
input
object
필수
parameters
object

응답

Task submitted, returns task_id and PENDING status

output
object
request_id
string

Unique request identifier

예시:

"..."