PopNow APIpopnow.ai
API 키 받기

Vidu

프레임 한 장을 1080p로 최대 16초 움직여요

vidu/q3/image-to-video53크레딧부터/ 5초 영상 · US$0.53
Playground에서 써 보기API 키 받기
  • 최대 1080p
  • 1–16초
  • 사운드 포함
  • 이미지로 영상 만들기
예시 보기

Vidu Q3 소개

Vidu Q3는 동영상 엔드포인트 image-to-video 하나를 공개합니다. 첫 프레임을 보내고 그다음에 일어날 일을 프롬프트로 적습니다. 클립은 540p, 720p, 1080p에서 1초부터 16초까지 나오고, 끄지 않는 한 오디오가 영상과 함께 생성됩니다.

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

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

요청 파라미터

파라미터필수설명
bgm아니요Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself. 기본값: 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 · 1080p · 기본값: 720p
seed아니요같은 숫자를 쓰면 같은 결과를 다시 얻을 수 있습니다. ≥ 0 · ≤ 2147483647

가격

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

옵션크레딧 /초≈ USD
resolution 540p10.5US$0.11
resolution 720p22.5US$0.23
resolution 1080p24US$0.24

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

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

API 빠른 시작

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

  1. API 키 만들기. PopNow에 로그인해 API 콘솔에서 키를 만드세요. 키는 sk-popnow-(으)로 시작하며 웹사이트와 같은 크레딧을 씁니다.
  2. 요청 보내기. POST /jobs/createTask에 model은 vidu/q3/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/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",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 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 API 질문

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

Vidu Q3 가격은 53크레딧(US$0.53) / 5초 영상입니다. 옵션별 가격: 540p 10.5크레딧/초, 720p 22.5크레딧/초, 1080p 24크레딧/초. 크레딧은 웹사이트와 같으며(1크레딧 = $0.01), 새 계정에는 30크레딧이 무료로 제공되고, 실패한 작업은 환불됩니다.

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

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

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

540p, 720p, 1080p를 지원하고 기본값은 720p입니다. 540p에서 움직임을 잡은 뒤, 승인한 테이크를 같은 프레임과 같은 seed로 1080p에서 다시 돌리는 방식이 가장 안정적입니다.

텍스트만으로 생성할 수 있나요?

이 패밀리에서는 안 됩니다. Vidu Q3는 image-to-video만 공개하므로 모든 요청에 image_url이 필요합니다. 글로 된 아이디어에서 시작한다면 이미지 모델로 첫 프레임을 먼저 만들어 확인한 뒤 여기서 움직이세요.

화면비는 어떻게 정하나요?

업로드하는 프레임으로 정해집니다. 이 엔드포인트에는 화면비 파라미터가 없습니다. 16:9 스틸은 16:9 클립이 되고 9:16 스틸은 세로 클립이 되니, 보내기 전에 이미지를 잘라 두세요.

소리도 만들어 주나요?

네. generate_audio 기본값이 true라 공간음과 폴리가 화면과 맞춰 들어옵니다. 무음 클립이면 false로 두세요. Q3 모델에는 음악 트랙용 스위치가 따로 없으므로 원하는 음악은 프롬프트에 적으세요.

Vidu Q3는 어떻게 과금되나요?

출력 길이 기준이고 해상도가 함께 반영됩니다. 제출 전에 보이는 실시간 추정치가 요청에 담긴 정확한 길이와 해상도를 반영합니다.

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

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

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

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

모든 Vidu 모델

Vidu Q4 Preview는 참고 장면, 클립 연장, 최대 4K 출력이 더해지고 초당 시작 가격도 더 낮아요.

Vidu Q3 더 알아보기