업데이트: 2026-06-07
비디오 생성 별칭
/v1/video/generations 경로를 고정적으로 사용하는 비디오 클라이언트나 미들웨어에 적합합니다.
인증
언제 사용하는가
- 클라이언트에 이미
/v1/video/generations가 하드코딩되어 있는 경우 - 기존 비디오 워크플로를 마이그레이션하며 호출 경로를 바꾸고 싶지 않은 경우
- 이미 배포된 서드파티 요청 형식과 호환해야 하는 경우
- Wan 텍스트-투-비디오를 제출해야 하는 경우, 예:
wan2.5-t2v-preview또는wan2.2-t2v-plus
- Wan 텍스트-투-비디오: 이 페이지의
POST /v1/video/generations사용 - Veo / 통합 비디오 워크플로:
POST /v1/video/create를 사용하고veo-3.1-fast또는veo-3.1-quality를 제출 - OpenAI 공식 호환 비디오 워크플로:
POST /v1/videos사용
최소 요청 예시
Wan 2.2 T2V Plus
cURL
범용 최소 예시
cURL
전형적인 성공 응답
로컬에서 확인된 오류 응답
로컬http://127.0.0.1:4000 환경에서 이 라우트는 이미 존재함이 검증되었습니다. 모델이 일시적으로 사용 불가할 때는 404가 아니라 비즈니스 오류가 반환됩니다.
유의사항
- 요청 본문 필드는 구체적인 비디오 모델과 업스트림 능력에 따라 달라집니다
model의 사용 가능 여부는 현재 Token 화이트리스트와 업스트림 채널 상태에 따라 결정됩니다- Wan 텍스트-투-비디오는
model,prompt,seconds,size를 사용합니다.wan2.2-t2v-plus의 검증된 조합은seconds: "5",size: "480P"또는"1080P"입니다. wan2.2-t2v-plus는/alibailian/api/v1/services/aigc/video-generation/video-synthesis로 제출해서는 안 됩니다.- 작업 생성이 성공하면 이어서
GET /v1/video/generations/{task_id}를 호출해 상태를 조회할 수 있습니다
이 라우트는 호환 별칭이며, 모든 비디오 모델이 완전히 동일한 요청 필드를 공유한다는 뜻은 아닙니다. Wan 텍스트-투-비디오는 현재 이 페이지의 라우트 사용을 권장하며, Veo 또는 통합 비디오 워크플로는
/v1/video/create를 사용해 veo-3.1-fast 또는 veo-3.1-quality를 제출해야 합니다.