API 키 받기

Vidu

사운드 포함 빠른 이미지 애니메이션, 최대 16초

vidu/q3-turbo/image-to-video32크레딧부터/ 5초 영상 · US$0.32
  • 최대 720p
  • 1–16초
  • 사운드 포함
  • 이미지로 영상 만들기
  • 영상 이어 만들기

Vidu Q3 Turbo 소개

Vidu Q3 Turbo는 Vidu Q3 라인의 빠른 등급이고 엔드포인트 두 개, image-to-video와 video-extend를 공개합니다. 직접 넣은 첫 프레임이 피사체와 출력 형태를 정하고, 프롬프트는 움직임을 지시합니다. 클립은 540p나 720p에서 1초부터 16초까지 나오고 오디오는 같은 생성 과정에서 함께 만들어집니다.

POST /jobs/createTask에서 모델 이름을 vidu/q3-turbo/image-to-video(으)로 지정하면 호출할 수 있습니다. 32크레딧/ 5초 영상부터(US$0.32). 새 계정에는 30크레딧이 지급되니 Playground에서 먼저 무료로 써 보세요.

이 가이드는 당분간 영어로만 제공됩니다. →

요청 파라미터

파라미터필수설명
bgm아니요Add a background music bed that fits the scene. 기본값: true
duration_seconds아니요클립 길이. 초 단위로 요금이 붙습니다. ≥ 1 · ≤ 16 · 기본값: 5
generate_audio아니요화면에 맞는 소리(목소리, 주변음, 효과음)를 더합니다. 기본값: true
image_url예출발점이 되는 이미지.
movement_amplitude아니요피사체와 카메라의 움직임 크기. auto · small · medium · large · 기본값: auto
prompt예Describe what happens after the opening frame: the action, the camera, and the mood.
resolution아니요출력 크기. 클수록 선명하고 가격도 올라갑니다. 540p · 720p · 기본값: 720p
seed아니요같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

가격은 웹사이트에서 쓰는 것과 같은 크레딧으로 표시됩니다(1크레딧 = $0.01). 작업이 접수될 때 먼저 보류되고, 끝나면 실제 요금으로 정산되며, 실패한 작업은 환불됩니다.

옵션크레딧 /초≈ USD
resolution 540p6.3US$0.063
resolution 720p9.9US$0.099

작업마다 크레딧은 정수로 올림 처리되므로, 가장 낮은 옵션으로 한 번 실행하면 32크레딧/ 5초 영상(US$0.32)입니다.

실행 전에 정확한 금액을 알고 싶다면 같은 본문을 POST /jobs/quote로 보내세요.

API 빠른 시작

Vidu Q3 Turbo API를 3단계로 호출하기

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 vidu/q3-turbo/image-to-video, input은 파라미터 표에 맞춰 보내세요. 응답으로 작업 ID가 바로 돌아옵니다.
  3. 결과 받기. 작업 ID로 GET /jobs/recordInfo를 폴링하거나 callBackUrl을 넘기면 결과를 그 주소로 보내 드립니다. 작업이 성공하면 출력 링크에서 내려받으세요.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $POPNOW_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{
  "model": "vidu/q3-turbo/image-to-video",
  "input": {
    "prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "movement_amplitude": "auto",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

프롬프트와 링크는 직접 쓰는 것으로 바꾸세요. 응답, 폴링, 콜백 참고 자료는 API 탭에 있어요.

Vidu Q3 Turbo API 질문

Vidu Q3 Turbo API 요금은 얼마인가요?

Vidu Q3 Turbo 가격은 가장 저렴한 이미지로 영상 만들기 기준 32크레딧(US$0.32) / 5초 영상부터입니다. 옵션별 가격: 540p 6.3크레딧/초, 720p 9.9크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

API에서 Vidu Q3 Turbo의 모델 이름은 무엇인가요?

POST /jobs/createTask의 model 필드에 이미지로 영상 만들기: vidu/q3-turbo/image-to-video; 영상 이어 만들기: vidu/q3-turbo/video-extend을(를) 넣으세요.

얼마나 움직일지는 어떻게 정하나요?

프롬프트와 movement_amplitude로 정합니다. 무게중심 이동, 반 바퀴 돌기, 화면 밖으로 걸어 나가기처럼 분명히 적어 첫 프레임에 보이는 내용과 맞는 움직임으로 두고, 전체 움직임의 양은 movement_amplitude(auto, small, medium, large)로 정하세요. 달라지는 것은 프레임 안에서 피사체가 이동하는 거리이지 클립 길이가 아닙니다.

클립은 얼마나 길 수 있나요?

1초에서 16초 사이의 정수 초입니다. 변형을 뽑을 때는 1~4초가 가장 쓸 만하고, 한 동작에 여유가 필요할 때 16초까지 쓸 수 있습니다.

어떤 해상도를 지원하나요?

540p와 720p이고 기본값은 720p입니다. 540p는 초안용, 720p는 납품용이고 둘 사이를 오가는 데 필요한 것은 같은 요청의 값 하나뿐입니다.

오디오도 만들어 주나요?

네. generate_audio 기본값이 true라 싱크가 맞은 트랙과 함께 클립이 도착합니다. 이미 있는 믹스 아래에 깔 거라면 false로 두세요.

Vidu Q3 Turbo API의 제한은 무엇인가요?

영상 길이: 1–16 s; 해상도: 540p · 720p. 이 범위를 벗어난 요청은 청구되기 전에 거부됩니다.

코드 없이 Vidu Q3 Turbo을(를) 써 볼 수 있나요?

네. Playground에서는 API 키 없이 PopNow 크레딧으로 Vidu Q3 Turbo을(를) 실행할 수 있고, 실행할 때마다 해당 코드를 보여 줍니다.

모든 Vidu 모델

Vidu Q3 Turbo 더 알아보기