Vidu Q4 Preview

지원하지 않습니다. viduq4-preview에는 이미지가 필요합니다. I2V는 첫 프레임 1장, R2V는 참조 이미지 1–15장을 사용하며 R2V에는 참조 오디오를 최대 3개 추가할 수 있습니다. 텍스트 전용 생성과 시작·마지막 프레임 제어는 지원하지 않습니다.

first_frame_image 또는 first_frame 역할은 I2V로 처리합니다. 역할 없는 이미지 1장에 참조 오디오가 없어도 I2V입니다. reference_image 역할(별칭 reference), 여러 이미지, 또는 역할 없는 이미지와 참조 오디오를 함께 쓰면 R2V입니다. 명시적 첫 프레임은 참조 이미지·오디오와 섞을 수 없습니다. image_urls와 image_with_roles의 참조 이미지는 합계 15장까지입니다. PNG, JPEG/JPG, WEBP는 장당 50 MB 이하이며 Base64 요청은 20 MB 미만이어야 합니다.

I2V에서는 프롬프트가 선택 사항이고 R2V에서는 필수이며, 두 모드 모두 최대 20,000자입니다. 원하는 동작, 장면, 참조 소재의 활용 방식을 설명하세요.

길이는 3–16초 정수(기본 5초)이며, 해상도는 540p, 720p, 1080p, 2K, 4K(기본 720p)입니다. R2V 화면비는 1:1, 9:16, 16:9, 3:4, 4:3이며 기본은 16:9입니다. aspect_ratio가 별칭 size보다 우선합니다. I2V는 두 필드를 무시하고 첫 프레임을 따릅니다.

생성 음성은 기본 true이며 false이면 같은 요금으로 무음 출력합니다. R2V에는 MP3 참조 오디오 0–3개를 추가할 수 있고 각각 3–12초, 50 MB까지입니다. 형식과 길이는 상위 서비스에서 확인하며 잘못된 오디오는 작업 실패 및 환불로 이어질 수 있습니다. seed는 정수이며 생략하거나 0으로 설정하면 무작위입니다.

I2V와 R2V의 요금은 같습니다. 길이에 선택 해상도의 현재 초당 요금을 곱하며 참조 이미지·오디오에는 소재 추가 요금이 없습니다. 생성 음성 유무도 같은 요금입니다. 실제 계정 요금을 확인하세요. 실패한 작업은 전액 환불됩니다.

POST /v1/videos/generations로 task_id를 받은 뒤 GET /v1/tasks/{task_id}를 5~10초 간격으로 조회하세요. completed 또는 failed까지 기다리고, 성공하면 result.videos[].url에서 영상 주소를 가져옵니다.

생성 영상은 72시간 이내에 저장하고 작업 응답의 만료 정보도 확인하세요. 조회 시간 초과가 생성 실패를 뜻하지는 않습니다. 새로 제출하지 말고 원래 작업 조회를 재개하세요.