소개
Vidu Q4 Preview Reference to video는 참조 이미지 115장과 음성 클립 최대 3개로 장면 하나를 만듭니다. Vidu Q4 Preview는 Vidu의 Q4 영상 모델을 공개 미리보기로 제공하는 것입니다. 클립은 540p에서 4k까지, 다섯 가지 화면 비율로 316초이며, 사운드는 화면과 함께 생성됩니다. 이 엔드포인트는 필터가 약하게 걸려 있어, 보통 단계 이상에서는 대부분의 요청이 수위가 낮춰지거나 거절됩니다.
시작 자료에 따라 모드 선택하기
| 가진 자료 | 모드 |
|---|---|
| 움직일 프레임 | Vidu Q4 Preview 이미지→동영상 |
| 이미지로 된 인물, 의상, 제품, 장소(음성 클립은 선택) | Vidu Q4 Preview 참조→동영상 |
핵심 기능 및 하이라이트
참조 이미지 최대 15장
인물, 의상, 제품, 장소를 함께 넣을 수 있습니다. 저희 테스트에서 얼굴, 옷, 공간이 하나의 장면으로 합쳐졌습니다.
두 사람 모두 알아볼 수 있게
인물 사진 두 장을 참조로 넣으면 같은 샷 안에서 두 얼굴이 모두 유지되었습니다.
참조 음성
오디오 클립 최대 3개가 목소리를 정합니다. 말의 내용은 여전히 프롬프트에서 나오므로 대사를 따옴표로 쓰십시오.
다섯 가지 형태와 다섯 단계
aspect_ratio는 16:9, 9:16, 1:1, 3:4, 4:3을 제공하고, resolution은 540p부터 4k까지이며 2k와 4k는 10비트 HEVC입니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
prompt | 예 | 필수이며 최대 20,000자입니다. 장면을 묘사하고 "the woman from the first image"처럼 참조를 순서로 가리키십시오. 1자 이상 · 20000자 이하 |
reference_image_urls | 예 | 필수이며 인물, 의상, 제품, 장소 이미지 1~15장입니다. 하나도 없는 요청은 거부됩니다. 1개 이상 · 15개 이하 |
reference_audio_urls | 아니요 | 선택이며 음성 클립 최대 3개입니다(Vidu는 클립마다 3~12초 길이의 MP3를 요구). 클립은 목소리를 정할 뿐 말의 내용은 정하지 않으므로, 대사는 프롬프트에 쓰고 그 목소리가 참조 오디오의 목소리라고 밝히십시오. 1개 이상 · 3개 이하 |
aspect_ratio | 아니요 | 16:9(기본값), 9:16, 1:1, 3:4, 4:3입니다. 가격에는 영향을 주지 않습니다. |
resolution | 아니요 | 540p, 720p(기본값), 1080p, 2k, 4k입니다. 초당 요금이 이 값으로 정해지며, 2k는 1080p보다 비싸고 4k는 2k의 약 두 배입니다. |
duration_seconds | 아니요 | 3~16의 정수 초이며 기본값은 5입니다. 해상도와 함께 초 단위로 과금됩니다. |
generate_audio | 아니요 | 기본으로 켜져 있어 대사, 효과음, 주변 소리가 화면과 함께 생성됩니다. 끄면 오디오 트랙이 없는 클립이 나옵니다. 기본값: |
seed | 아니요 | 한 번에 하나씩만 바꾸는 동안 결과를 비교하기 쉽게 해 줍니다. 프레임 단위로 똑같은 클립을 보장하지는 않습니다. |
요금
선택한 해상도로 출력 초 단위로 과금됩니다. 소리, 참조 이미지 수, 참조 오디오 클립 수는 가격에 영향을 주지 않습니다. 거부된 요청에는 요금이 부과되지 않습니다.
| 사양 | 요금 |
|---|---|
| $0.045 / 초 |
| $0.095 / 초 |
| $0.12 / 초 |
| $0.19 / 초 |
| $0.39 / 초 |
활용 사례
패션·제품 장면
모델, 의상, 장소를 한 클립에 담습니다.
두 사람이 나오는 샷
두 얼굴이 유지된 채 이어지는 대화, 도착, 입맞춤 직전의 순간입니다.
목소리가 있는 캐릭터
인물 사진 한 장에 음성 클립과 따옴표 대사를 더합니다.
프롬프트 가이드 및 실전 팁
순서로 가리키십시오
"the woman from the first image", "the robe from the second image"처럼 쓰십시오.
대사를 직접 쓰십시오
음성 클립은 말의 내용을 채워 주지 않습니다. 대사를 따옴표로 적고 그 목소리가 참조 오디오의 목소리라고 밝히십시오.
필터를 알아 두십시오
약함 요청은 통과했고, 최대 단계 프롬프트 두 개 중 하나도 통과했습니다. 보통 이상은 저희 테스트에서 나머지가 거절되거나 수위가 낮춰졌으며, 거절된 요청에는 과금되지 않습니다. 이 한계를 넘는 장면은 인물이 담긴 프레임에서 이미지-투-비디오를 사용하세요.
540p로 시안을 잡으십시오
540p로 프롬프트를 시험한 뒤 1080p로 마무리하십시오. 2k나 4k는 HEVC 파일을 다룰 수 있을 때만 고르십시오.
API 빠른 시작
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "vidu/q4-preview/reference-to-video",
"input": {
"aspect_ratio": "16:9",
"duration_seconds": 5,
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"reference_image_urls": [
"https://example.com/reference.png"
],
"resolution": "720p"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
인증, 전체 스키마, 폴링과 오류 처리는 API 레퍼런스에서 확인하세요.












