소개
Vidu Q3 Turbo는 Vidu Q3 라인의 빠른 등급으로, 이미지→영상과 video-extend 엔드포인트로 제공됩니다. 이 페이지는 이미지→영상을 다룹니다. image_url의 시작 프레임이 인물과 출력 형태를 정하고, 필수인 prompt가 움직임, 카메라, 소리를 지시합니다. 클립은 1~16초(정수 초)이며 해상도는 540p 또는 720p, 기본값은 720p입니다. 오디오는 같은 과정에서 생성되며 generate_audio를 false로 바꾸지 않는 한 켜져 있습니다. 정지 이미지 한 장으로 여러 움직임을 먼저 시험해 보고 납품할 테이크를 정하도록 설계된 등급입니다.
핵심 기능 및 하이라이트
시안용 값과 납품용 값
resolution은 540p와 720p를 받으며, 720p가 이 엔드포인트의 기본값이자 상한입니다. 두 값은 짝으로 씁니다. 540p는 움직임을 아직 정하는 단계에, 720p는 납품할 테이크에 씁니다. 해상도는 필드 하나이므로 값을 바꿔도 프롬프트, 프레임, seed는 그대로입니다.
프레임 한 장에서 짧은 변형들
길이는 116초(정수 초)이며, 변형을 만드는 단계에서는 14초가 실용적인 범위입니다. 공들인 지시 하나를 써 놓고 잘되기를 바라기보다 같은 정지 이미지에서 움직임을 하나씩 달리한 짧은 테이크를 여러 개 생성하고, 잘 읽히는 것을 남기십시오.
인물과 형태는 정지 이미지가 정합니다
인물, 의상, 스타일링, 프레이밍, 출력 형태는 프롬프트가 아니라 이미지에서 오므로, 같은 프레임에서 나온 두 번의 생성은 화면에 누가 있는지가 아니라 움직임만 다릅니다. 전체 움직임의 양은 movement_amplitude가 정하고, 무엇이 움직일지는 프롬프트가 정합니다. 정지 이미지와 어긋나는 글을 쓰면 둘 사이에서 타협한 듯한 클립이 나오므로, 프롬프트는 프레임에 보이는 내용과 일치하게 쓰십시오.
요청 파라미터
| 파라미터 | 필수 | 설명 |
|---|---|---|
image_url | 예 | 필수입니다. 피사체와 룩, 출력 형태를 고정합니다. |
prompt | 예 | 필수입니다. 움직임과 카메라, 소리만 적으세요. 1자 이상 |
movement_amplitude | 아니요 | 화면 속 대상이 얼마나 움직일지 정합니다. |
duration_seconds | 아니요 | 정수 초로 1에서 16까지입니다. 변형을 훑을 때는 1~4초가 현실적인 범위입니다. |
resolution | 아니요 | 540p 또는 720p입니다. 움직임이 정해질 때까지는 540p로 시험하고, 납품할 한 컷만 720p로 올리십시오. |
generate_audio | 아니요 | 기본으로 켜져 있습니다. 이미 있는 믹스 아래에 깔 컷이라면 false로 두세요. 기본값: |
bgm | 아니요 | 장면 분위기에 맞는 배경음악을 깝니다. 기본값은 켜짐입니다. 기본값: |
seed | 아니요 | 변수 하나만 바꿔 두 실행을 비교할 때 쓸모 있습니다. 프레임까지 같다는 보장은 아닙니다. |
요금
| 사양 | 요금 |
|---|---|
| $0.042 / 초 |
| $0.066 / 초 |
활용 사례
캐릭터 리액션 세트
의상을 입은 정지 이미지 한 장이 인사, 윙크, 손 흔들기, 고개 기울이기가 됩니다. 프레임은 같고 프롬프트만 다른 네 번의 요청입니다. 이미지가 정체성을 고정하므로 세트 전체가 피드에서 이어 붙일 수 있을 만큼 일관성을 유지합니다.
정사각형과 세로형 소셜 컷
출력 형태는 정지 이미지에서 오므로 9:16 세로 이미지와 1:1 정사각형은 서로 다른 영상 설정이 아니라 이미지 단계에서 두 번 내보낸 결과입니다. 각각 소리가 싱크된 720p 클립으로 움직입니다.
정지 이미지 한 장으로 카메라 움직임 시험
푸시인 예시는 카메라 움직임 하나만 요청하고 그 밖에는 아무것도 요청하지 않습니다. 프레임이 조금씩 좁혀져 결국 어깨만 남습니다. 긴 지시를 쓰기 전에 화면이 좁혀져도 인물이 무너지지 않는지 확인하고 싶다면 같은 방식을 쓰십시오.
직접 준비한 정지 이미지로 만드는 무검열 루프
무검열 원본 프레임도 받은 그대로 움직입니다. 1~4초 범위는 몇 장의 정지 이미지로 짧은 변형 세트를 만드는 데 알맞습니다. 같은 라인의 Vidu Q3 Spicy는 LoRA로 튜닝한 무검열 변형입니다.
프롬프트 가이드 및 실전 팁
납품물의 형태로 정지 이미지를 내보냅니다
돌려받을 형태대로, 즉 정사각형 클립이면 정사각형으로, 세로형이면 세로로 자르고 비율은 1:4~4:1 안에 두십시오. 영상 단계에서는 바뀌지 않으므로 의상, 스타일링, 프레이밍은 여기서 확정합니다.
요청 하나에 흐름 하나를 씁니다
프롬프트는 움직임, 카메라, 소리에 한정하고 프레임을 다시 묘사하지 마십시오. 공개된 카페 예시는 고양이 귀 머리띠를 하고 쟁반을 든 캐릭터의 정사각형 정지 이미지에서 generate_audio를 켜고 5초, 720p로 만든 것입니다.
She walks two steps toward camera balancing the tray, does a small curtsy, winks and mouths a silent greeting, the cat-ear headband bobbing. Handheld follow that stays with her, bright café chatter and an espresso machine behind.
정사각형 정지 이미지 한 장에서 만든 5초, 720p입니다. 걸어오기, 인사, 윙크는 글로 썼고 의상과 1:1 프레임은 이미지에서 왔습니다.
타이밍과 디테일은 말로 요청합니다
슬로 모션에는 필드가 없으므로 프롬프트에 적습니다. 수영장 예시는 그녀가 수영장 가장자리로 몸을 끌어올리는 장면에 슬로 모션과 느린 푸시인을 요청하며, 살펴볼 부분은 두 손으로 넘기는 젖은 머리카락입니다. 머리카락 가닥이 제대로 뭉치고 갈라지는지가 움직이는 사진과의 차이를 만듭니다. 거리 변화도 마찬가지입니다. 침대 끝 예시에서는 카메라가 그대로 있고 그녀가 한 걸음 다가오므로 초점이 그녀를 따라 옮겨 가야 합니다.
고른 테이크를 720p로 마무리합니다
540p 시안이 만족스러우면 프롬프트, 프레임, seed는 그대로 두고 resolution을 720p로 바꾸십시오. seed는 비교를 공정하게 해 주지만 프레임 단위로 같은 결과를 보장하지 않으므로 납품 테이크는 따로 검수하십시오. 받은 그대로 쓸 클립이면 generate_audio를 켜 두고, 기존 믹스 아래에 들어갈 컷이면 false로 설정합니다.
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-turbo/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": "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 레퍼런스에서 확인하세요.
