동영상 생성
네이티브 입력 구조로 Wan 3.0 동영상 작업을 생성합니다.
model/input/parameters로 표준 모델 작업을 제출합니다. 네이티브 형식도 플랫폼 API 주소와 API Key를 사용하며 Alibaba Cloud Workspace ID는 필요하지 않습니다. 비동기는 자동 활성화되므로 X-DashScope-Async를 추가하지 않아도 됩니다.
/api/v1/services/aigc/video-generation/video-synthesis소재 및 조합 규칙
프롬프트 또는 비어 있지 않은 media가 필요합니다. 이미지, 동영상, 오디오는 배열 내 같은 유형의 순서로 따로 번호를 매기며 “图1”, “视频1”, “音频1”로 참조합니다. 소재 참조 ID는 필요하지 않습니다.
| 소재 | 형식 및 수량 | 주요 제한 |
|---|---|---|
| 시작·끝 프레임 | first_frame, last_frame 각 최대 1장 | 끝 프레임에는 시작 프레임이 필요하며 참조 이미지·동영상·오디오·파일·웹페이지와 함께 사용 불가 |
| 참조 이미지 | 최대 10개 reference_image | JPEG/JPG/PNG(알파 없음)/BMP/WEBP; 각 20MB 이하; 각 변 240–8000px; 비율 최대 8:1 |
| 참조 동영상 | 최대 5개 reference_video | MP4/MOV; 각 1–15초, 총 15초 이하; 파일당 100MB 이하; 각 변 240–4096px; 최소 16fps; 비율 최대 8:1 |
| 참조 오디오 | 최대 5개 reference_audio | WAV/MP3; 각 1–15초, 총 15초 이하; 파일당 15MB 이하 |
| 파일 | 최대 1개 file | 100MB 이하; PDF, Word, PowerPoint, Keynote, Pages는 50페이지 이하; 형식은 필드 표 참고 |
| 웹페이지 | 최대 1개 link | 로그인 없는 공개 HTTP/HTTPS 페이지, 파일과 함께 사용 불가 |
시작·끝 프레임의 형식·용량·크기 규칙은 참조 이미지와 같습니다. 이미지는 공개 URL 또는 data:image/png;base64,... 같은 접두사 포함 Base64를, 다른 소재는 URL을 사용합니다. 일반 소재는 접근 가능한 OSS도 지원하며 웹페이지는 HTTP/HTTPS만 사용합니다. 웹페이지 외 URL에 확장자가 있으면 소재 형식과 맞아야 하며 없어도 실제 규격을 충족해야 합니다.
참조 이미지·동영상·오디오는 함께 사용할 수 있고 파일 또는 웹페이지도 추가할 수 있지만 file과 link는 상호 배타적입니다. 파일·웹페이지에는 prompt_extend를 켜세요. 편집·연장은 참조 동영상과 프롬프트로 지정하며 연장에는 ratio: "adaptive"를 사용합니다.
길이는 -1 지능형 또는 2～30초 정수입니다. 참조 동영상이 있으면 입력과 출력 길이의 합이 30초를 넘을 수 없습니다.
생성 결과와 다음 단계
제출 후 output.task_id를 저장하고 네이티브 조회 API로 상태·결과를 가져오세요. request_id는 추적용이며 작업 조회에 사용하지 않습니다. 진행률 확인을 위해 같은 작업을 다시 생성하지 마세요.
공통 필드를 사용하려면 플랫폼 형식 생성을 선택하세요. 두 형식을 혼합하지 마세요.
자주 발생하는 오류
HTTP 400이면 오류에 따라 JSON, 모델 이름, input/parameters, 소재 조합을 확인하세요. 오류는 code/message/data 또는 중첩 error로 반환될 수 있습니다. 지원팀에는 오류와 요청 ID만 제공하고 API Key는 제공하지 마세요.