Skip to main content
POST
Wan 2.5 비디오 생성

소개

Wan 2.5는 Alibaba Cloud Bailian의 비디오 생성 제품군으로, 텍스트-투-비디오(wan2.5-t2v-preview)와 이미지-투-비디오(wan2.5-i2v-preview)로 구성됩니다. 480P, 720P, 1080P 출력을 지원합니다. GravitexAI 통합 비디오 API를 사용하세요: 작업 제출로 작업 id를 받은 후 작업 조회로 상태를 폴링하고 비디오 URL을 확인합니다.
Wan 2.5는 metadata.inputmetadata.parameters를 통해 기본 DashScope 매개변수를 전달하는 것을 권장합니다. 최상위 prompt, duration 등은 호환용이며, 실제 적용은 metadata.parameters가 우선합니다.

인증

string
필수
Bearer Token, 예: Bearer sk-xxxxxxxxxx

지원 모델

호출 흐름

  1. 제출: model, promptmetadata의 Wan 매개변수와 함께 POST /v1/video/generations.
  2. 폴링: GET /llm-api/v1/video/generations/{id}(호스트 maas.gravitex.ai)를 3~15초마다 호출하여 data.statuscompleted 또는 failed가 될 때까지 대기.
  3. 결과: 성공 시 data.url, data.video_url 또는 data.metadata.output.video_url에서 비디오 주소 확인(일반적으로 임시 링크—즉시 다운로드 권장).

요청 구조

제출 응답

제출 API는 OpenAI Video 스타일 객체를 반환하며, 후속 조회에는 id를 작업 ID로 사용합니다:

조회 응답

조회 API는 래핑된 구조를 반환하며, data.statuscompleted이면 성공입니다:

사용 사례

텍스트 프롬프트로 비디오를 생성합니다. 스마트 프롬프트 재작성, 사용자 지정 해상도 및 화면 비율을 지원합니다.
string
필수
텍스트 프롬프트; 최상위 prompt와 동기화 권장
string
기본값:"720P"
480P, 720P 또는 1080P
string
기본값:"16:9"
화면 비율: 16:9, 9:16, 1:1, 4:3, 3:4
integer
기본값:"5"
비디오 길이(초); 일반적인 값: 3, 5, 10
boolean
기본값:"true"
스마트 프롬프트 재작성 활성화
boolean
기본값:"false"
워터마크 추가
integer
랜덤 시드, 범위 [0, 2147483647]
텍스트-투-비디오 예시:

매개변수 참조

metadata.parameters

metadata.input

조회 응답 주요 필드

상태 매핑

오류 처리

실패 시 data.statusfailed이며, data.metadata.output.task_status로 원인을 확인할 수 있습니다.

자주 묻는 질문

metadata.parameters.duration이 우선합니다. 운영 환경에서는 최상위 duration을 생략하거나 두 값을 동일하게 유지하세요.
최상위 promptmetadata.input.prompt동일하게 유지하면 조회 결과의 orig_prompt와 요청이 일치합니다.
video_url은 일반적으로 임시 OSS 링크입니다. 성공 후 즉시 다운로드하여 자체 저장소에 보관하세요.
다음 순서로 확인하세요:
  1. data.status == "completed"
  2. data.video_url 또는 data.url이 비어 있지 않음
  3. data.metadata.output.task_status == "SUCCEEDED"
Wan 2.5는 텍스트-투-비디오와 첫 프레임 이미지-투-비디오만 지원하며, 2.7의 media 배열 대신 metadata.input.img_url을 사용합니다. Wan 2.7은 참조-투-비디오, 연속 생성, 첫+마지막 프레임 등 추가 기능을 제공합니다. Wan 2.7을 참조하세요.

관련 API

비디오 작업 제출

통합 비디오 작업 제출 및 다중 모델 매개변수

비디오 작업 조회

작업 상태 폴링 및 비디오 URL 확인