Wan 2.5 비디오 생성
비디오 시리즈
Wan 2.5 비디오 생성
Alibaba Wan 2.5 텍스트-투-비디오, 이미지-투-비디오
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.input 및 metadata.parameters를 통해 기본 DashScope 매개변수를 전달하는 것을 권장합니다. 최상위 prompt, duration 등은 호환용이며, 실제 적용은 metadata.parameters가 우선합니다.인증
string
필수
Bearer Token, 예:
Bearer sk-xxxxxxxxxx지원 모델
호출 흐름
- 제출:
model,prompt및metadata의 Wan 매개변수와 함께POST /v1/video/generations. - 폴링:
GET /llm-api/v1/video/generations/{id}(호스트maas.gravitex.ai)를 3~15초마다 호출하여data.status가completed또는failed가 될 때까지 대기. - 결과: 성공 시
data.url,data.video_url또는data.metadata.output.video_url에서 비디오 주소 확인(일반적으로 임시 링크—즉시 다운로드 권장).
요청 구조
제출 응답
제출 API는 OpenAI Video 스타일 객체를 반환하며, 후속 조회에는id를 작업 ID로 사용합니다:
조회 응답
조회 API는 래핑된 구조를 반환하며,data.status가 completed이면 성공입니다:
사용 사례
- 텍스트-투-비디오 (T2V)
- 이미지-투-비디오 (I2V)
텍스트 프롬프트로 비디오를 생성합니다. 스마트 프롬프트 재작성, 사용자 지정 해상도 및 화면 비율을 지원합니다.텍스트-투-비디오 예시:
string
필수
텍스트 프롬프트; 최상위
prompt와 동기화 권장string
기본값:"720P"
480P, 720P 또는 1080Pstring
기본값:"16:9"
화면 비율:
16:9, 9:16, 1:1, 4:3, 3:4integer
기본값:"5"
비디오 길이(초); 일반적인 값: 3, 5, 10
boolean
기본값:"true"
스마트 프롬프트 재작성 활성화
boolean
기본값:"false"
워터마크 추가
integer
랜덤 시드, 범위
[0, 2147483647]매개변수 참조
metadata.parameters
metadata.input
조회 응답 주요 필드
상태 매핑
오류 처리
실패 시
data.status는 failed이며, data.metadata.output.task_status로 원인을 확인할 수 있습니다.
자주 묻는 질문
최상위 duration과 metadata.parameters.duration이 다르면?
최상위 duration과 metadata.parameters.duration이 다르면?
metadata.parameters.duration이 우선합니다. 운영 환경에서는 최상위 duration을 생략하거나 두 값을 동일하게 유지하세요.prompt는 몇 번 전달해야 하나요?
prompt는 몇 번 전달해야 하나요?
최상위
prompt와 metadata.input.prompt를 동일하게 유지하면 조회 결과의 orig_prompt와 요청이 일치합니다.생성된 비디오 링크 유효 기간은?
생성된 비디오 링크 유효 기간은?
video_url은 일반적으로 임시 OSS 링크입니다. 성공 후 즉시 다운로드하여 자체 저장소에 보관하세요.작업 성공 여부는 어떻게 판단하나요?
작업 성공 여부는 어떻게 판단하나요?
다음 순서로 확인하세요:
data.status == "completed"data.video_url또는data.url이 비어 있지 않음data.metadata.output.task_status == "SUCCEEDED"
Wan 2.5와 Wan 2.7의 차이는?
Wan 2.5와 Wan 2.7의 차이는?
Wan 2.5는 텍스트-투-비디오와 첫 프레임 이미지-투-비디오만 지원하며, 2.7의
media 배열 대신 metadata.input.img_url을 사용합니다. Wan 2.7은 참조-투-비디오, 연속 생성, 첫+마지막 프레임 등 추가 기능을 제공합니다. Wan 2.7을 참조하세요.관련 API
비디오 작업 제출
통합 비디오 작업 제출 및 다중 모델 매개변수
비디오 작업 조회
작업 상태 폴링 및 비디오 URL 확인
