소개
Vidu Q3 Pro는 Vidu Q3 영상 라인의 Pro 등급으로, 이미지→영상 엔드포인트 하나로 제공됩니다. image_url에 시작 프레임을, prompt에 지시를 보내면(둘 다 필수) 같은 과정에서 생성된 오디오가 포함된 116초(정수 초) 길이의 540p 영상을 받습니다. 인물, 룩, 출력 형태는 프레임이 정합니다. 화면비 필드가 없고 이미지 자체의 비율은 1:44:1 범위여야 하므로, 프롬프트에는 움직이는 것만 쓰면 됩니다.
핵심 기능 및 하이라이트
해상도가 하나이므로 정할 것은 길이뿐입니다
resolution이 받는 값은 540p 하나이며 모든 클립이 이 크기로 돌아옵니다. 남는 설정은 duration_seconds(1~16 사이의 정수, 기본값 5)로, 클립 길이와 가격을 함께 바꾸며 값을 움직일 때마다 예상 금액도 따라 바뀝니다.
인물의 정체성은 정지 이미지에서 옵니다
인물, 의상, 프레이밍, 출력 형태는 프롬프트가 아니라 이미지가 정합니다. 같은 프레임에서 나온 두 번의 생성은 화면에 누가 있는지가 아니라 움직임만 다르기 때문에, 정지 이미지 한 장으로 만든 여러 클립을 이어 붙일 수 있습니다. 또한 이미지 단계에서 승인된 내용을 영상 요청이 다시 쓸 수 없습니다.
움직임은 글로 쓰고 양은 설정으로 정합니다
movement_amplitude가 전체 움직임의 양을 정하고(기본값 auto, 그 밖에 small, medium, large), 무엇이 어떻게 움직일지는 프롬프트에 씁니다. 테이크가 너무 많이 또는 너무 적게 움직이면 seed와 프레임을 고정한 채 더 작은 회전, 더 느린 걸음처럼 움직임만 고쳐 쓰십시오. 그래야 보이는 차이가 새로운 추첨이 아니라 그 한 번의 수정에서 나옵니다.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 필수입니다. 첫 프레임으로 피사체와 룩, 출력 형태를 고정합니다. |
prompt | 예 | 필수입니다. 프레임 다음의 움직임과 카메라, 소리를 적으세요. 1자 이상 |
movement_amplitude | 아니요 | 화면 속 대상이 얼마나 움직일지 정합니다. |
duration_seconds | 아니요 | 정수 초로 1에서 16까지입니다. |
resolution | 아니요 | 이 엔드포인트는 540p만 받습니다. 받는 값이 그것뿐이라 모든 클립이 같은 크기로 돌아옵니다. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 무음 클립을 원하면 false로 두세요. 기본값: |
bgm | 아니요 | 장면 분위기에 맞는 배경음악을 깝니다. 기본값은 켜짐입니다. 기본값: |
seed | 아니요 | 두 실행을 통제된 조건에서 비교할 때 씁니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.054 / 초 |
활용 사례
한 캐릭터의 리액션 세트
의상을 입은 프레임 한 장이 윙크, 손 흔들기, 고개 기울이기, 돌아서기가 됩니다. 이미지는 같고 프롬프트만 다른 네 번의 요청입니다. 정체성이 프레임으로 고정되므로 클립 사이에서 인물이 어긋나지 않고 이어집니다.
가까이서 보는 리듬감 있는 동작
대장간 예시는 아래에서 불빛을 받는 대장장이의 가슴과 팔뚝에 6초 동안 바짝 붙어 있고, 망치가 내려칠 때마다 불꽃이 튑니다. 반복되는 타격은 이 엔드포인트를 점검하기 좋은 소재입니다. 불꽃이 타격 사이가 아니라 타격하는 순간에 튀는지 확인하십시오.
세로형 납품물
정지 이미지를 9:16으로 내보내면 클립도 세로로 돌아옵니다. 지하도 예시에서 프롬프트가 맡는 것은 형광등 아래를 지나 렌즈를 향해 걷는 동작과 그녀와 같은 속도로 물러나는 카메라뿐이며, 세로 프레이밍은 이미지 단계에서 이미 정해졌습니다.
직접 준비한 프레임에서 시작하는 무검열 장면
정지 이미지는 순화되지 않고 받은 그대로 움직입니다. 내용은 이미지가 담고 있으므로 결과가 승인한 내용에 가깝게 유지됩니다. 같은 라인의 Vidu Q3 Spicy는 LoRA로 튜닝한 무검열 버전입니다.
프롬프트 가이드 및 실전 팁
필요한 형태로 정지 이미지를 내보냅니다
출력은 프레임을 따릅니다. 세로 클립은 세로 이미지에서, 정사각형 클립은 정사각형 이미지에서 시작하며 비율은 1:4~4:1 안에 있어야 합니다. 영상 요청으로는 바뀌지 않으므로 의상, 스타일링, 구도도 이미지 단계에서 확정하십시오.
움직이는 것만 씁니다
프롬프트는 동작의 한 박자, 카메라, 소리에 한정하고 그림을 다시 묘사하지 마십시오. 공개된 예시는 그려진 무대 프레임에서 generate_audio를 켜고 8초, 540p로 만든 것이며, 지시 전체가 두 문장입니다.
She lowers the microphone, tilts her head and winks at the crowd; glowsticks sway out of focus behind her. Slow dolly-in, haze catching the backlight, crowd roar swelling.
그려진 무대 프레임 한 장에서 만든 8초입니다. 윙크, 돌리인, 관객의 함성은 프롬프트가 맡았고 의상과 선화는 이미지에서 왔습니다.
소리를 지시 안에 씁니다
generate_audio의 기본값은 true이고 오디오는 화면과 함께 생성되므로, 원하는 소리를 그 소리가 속한 동작 바로 옆에 적으십시오. 무대 예시는 카메라가 다가갈수록 관객의 함성이 커지도록 요청합니다. 이미 있는 믹스 아래에 들어갈 컷이라면 false로 설정합니다. 배경음악은 별도 스위치인 bgm이 맡으며 기본값은 켜짐입니다. 장면 자체의 소리만 원하면 끄십시오.
고정한 seed로 테이크를 비교합니다
프레임과 seed를 고정하고 프롬프트의 한 구절만 바꾸면 두 번의 생성은 그 수정만큼만 달라집니다. seed는 생성을 비교하기 쉽게 해 줄 뿐 같은 프레임을 보장하지 않습니다. 인물의 모습을 바꿔야 한다면 프롬프트가 아니라 정지 이미지를 바꾸십시오. 이 엔드포인트에서 화면에 누가 나오는지는 글이 아니라 이미지가 정합니다.
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/q3-pro/image-to-video",
"input": {
"duration_seconds": 5,
"image_url": "https://example.com/reference.png",
"movement_amplitude": "auto",
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"resolution": "540p"
}
}'
# 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 레퍼런스에서 확인하세요.
