Skip to main content
POST
Text-to-video: create a video generation task from a text prompt
오른쪽의 Playground에서는 직접 디버깅할 수 있습니다. Bearer sk-your-api-keyAuthorization에 넣고, model / input / parameters를 입력한 뒤 요청을 전송하십시오. 성공적으로 제출하면 task_id가 반환됩니다. 폴링과 다운로드는 아래를 참조하십시오.
이 페이지는 wan2.7-t2v(텍스트-투-비디오)의 생성 엔드포인트입니다. 필요한 것은 텍스트 prompt뿐이며, 미디어는 필요하지 않습니다. 이미지를 움직이게 하거나 주제 특징을 유지하려면 대신 이미지-투-비디오 / 레퍼런스-투-비디오를 사용하십시오. 전체 비동기 흐름, 상태 표, Python 클라이언트는 Wan 개요를 참조하십시오.
  • 생성 요청은 헤더 X-DashScope-Async: enable와 함께 /wan/api/v1/services/aigc/video-generation/video-synthesis로 보내야 합니다. /v1/videos를 사용하지 마십시오.
  • duration정수여야 하며(5, "5"가 아님), resolution대문자로 작성해야 합니다(720P).

코드 예제

매개변수 빠른 참조

응답 형식

생성에 성공하면 task_id를 반환합니다 (동영상 자체는 아님):

상태 확인 및 다운로드

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가 이미 있는 경우”를 위한 빠른 확인/다운로드 경로입니다. 전체 폴링 루프(타임아웃 대체 동작 포함)와 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, otherwise it returns current user api does not support synchronous calls

사용 가능한 옵션:
enable

본문

application/json
model
enum<string>
기본값:wan2.7-t2v
필수

Model ID; for text-to-video, fixed wan2.7-t2v (legacy version wan2.6-t2v)

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

응답

Task submitted; returns task_id and PENDING status

output
object
request_id
string

Unique request identifier; provide it to support when troubleshooting

예시:

"a23b81b0-0c05-9972-a6c9-ee757400afdb"