비디오

Vidu Q4 Preview API

APIMart의 Vidu Q4 API(model ID viduq4-preview, viduq4로도 표기): ShengShu의 Vidu Q4 Preview는 첫 프레임 1장, 또는 레퍼런스 이미지 1~15장과 최대 3개의 참고 오디오로 3~16초, 최대 4K 영상을 만들고 기본으로 오디오도 생성합니다. APIMart Vidu API 시리즈의 최신 모델입니다.

이미지-영상 생성참조 기반 동영상3~16초최대 4K

API 키 발급 API 문서

서비스 하이라이트

공식 할인
종량제
고속 & 저지연

Input

모델

생성 모드

첫 프레임

프롬프트

해상도

길이5s

오디오 생성

시드

Output

Video link valid for 72 hours

요금 상세

숨겨진 수수료 없는 투명한 요금제. 사용한 만큼만 지불하세요.

모델	등급	골드 가격현재 가격	플래티넘 가격	다이아몬드 가격	공식 가격	절약률
`viduq4-preview`	540p	0.448Credits(~$0.0448)/초	0.4256Credits(~$0.0426)/초	0.4032Credits(~$0.0403)/초	0.56Credits(~$0.056)/초	20%
	720p	0.912Credits(~$0.0912)/초	0.8664Credits(~$0.0866)/초	0.8208Credits(~$0.0821)/초	1.14Credits(~$0.114)/초	20%
	1080p	1.024Credits(~$0.1024)/초	0.9728Credits(~$0.0973)/초	0.9216Credits(~$0.0922)/초	1.28Credits(~$0.128)/초	20%
	2K	1.624Credits(~$0.1624)/초	1.5428Credits(~$0.1543)/초	1.4616Credits(~$0.1462)/초	2.03Credits(~$0.203)/초	20%
	4K	3.328Credits(~$0.3328)/초	3.1616Credits(~$0.3162)/초	2.9952Credits(~$0.2995)/초	4.16Credits(~$0.416)/초	20%

* 실제 비용은 최종 출력에 따라 달라집니다.

Vidu Q4 API: 이미지와 레퍼런스로 최대 4K 영상 생성

위 생성기에서 Vidu Q4 영상을 온라인으로 만들거나 앱에서 Vidu Q4 API를 호출하세요. 첫 프레임 1장과 선택 프롬프트로 시작하거나, 레퍼런스 이미지 1~15장·프롬프트·최대 3개의 MP3를 조합합니다. 3~16초, 540p~4K를 고를 수 있고 오디오는 기본으로 켜져 있으며 가격은 같습니다.

Vidu Q4 Preview API 기능

지원 이미지 입력, 출력 설정과 비동기 작업 처리

첫 프레임 또는 참조 이미지

I2V는 첫 프레임 1장, R2V는 참조 이미지 1–15장을 사용합니다. PNG, JPEG, WEBP를 장당 50 MB까지 지원합니다. 텍스트만 입력하거나 마지막 프레임을 지정할 수는 없습니다.

생성 모드별 프롬프트

최대 20,000자로 동작, 카메라 움직임, 장면을 설명하세요. 첫 프레임 생성에서는 선택 사항이고 참조 기반 생성에서는 필수입니다.

다섯 가지 해상도

540p, 720p, 1080p, 2K, 4K 중에서 선택하세요. 기본값은 720p이며 게시 채널, 영상 요구 사항과 예산에 맞게 설정할 수 있습니다.

3~16초 영상

3~16초 사이의 정수 길이를 지정할 수 있으며 기본값은 5초입니다. 짧은 영상으로 동작을 검토한 뒤 더 긴 장면을 계획할 수 있습니다.

생성 음성 및 참조 오디오

생성 음성은 기본으로 켜져 있고 꺼도 요금이 같습니다. 참조 모드는 MP3를 최대 3개, 각각 3–12초 및 50 MB까지 사용할 수 있으며 소재 추가 요금은 없습니다.

시드 설정

정수 시드로 관련 결과를 탐색하세요. 생략하거나 0으로 설정하면 무작위 시드를 사용합니다. 게시 전에는 생성된 동작과 내용의 적합성을 검토하세요.

통합 비동기 작업

POST /v1/videos/generations로 제출하고 task_id를 보관하세요. 완료 또는 실패까지 GET /v1/tasks/{task_id}로 조회하며 새 작업을 중복 생성하지 않습니다.

해상도와 길이에 따른 요금

두 모드 모두 길이에 선택 해상도의 현재 초당 요금을 곱합니다. 참조 이미지, 참조 오디오, 생성 음성에는 추가 요금이 없습니다. 계정의 실시간 요금을 확인하세요. 실패한 작업은 전액 환불됩니다.

이미지·참조 기반 동영상 활용 사례

검토된 첫 프레임이나 참조 소재에서 시작하는 제작 흐름

제품과 브랜드 영상

제품 사진에 움직임을 더해 짧은 홍보 장면을 만드세요. 프롬프트로 동작을 제안하고 결과의 제품 세부 사항과 브랜드 적합성을 검토합니다.

소셜 콘텐츠

선택한 이미지를 3~16초 길이의 영상 도입부로 바꿉니다. 게시 채널에 맞는 해상도와 오디오 또는 무음 출력을 선택할 수 있습니다.

스토리보드와 제안

스토리보드 한 장에 움직임을 더하거나 참조 이미지와 프롬프트로 장면 및 카메라 방향을 탐색하세요. 편집물에 넣기 전에 각 클립을 확인하세요.

캐릭터 동작 연구

초상화나 일러스트의 동작을 탐색하고, 캐릭터 참조 이미지와 선택적 참조 오디오로 장면을 이끄세요. 사용 전에 정체성, 움직임, 적합성을 검토하세요.

교육과 설명 콘텐츠

준비한 장면이나 그림에 움직임을 더해 짧은 교육 영상으로 활용합니다. 시각적 정확성을 검토하고 편집 단계에서 검증된 해설이나 자막을 추가합니다.

게임 콘셉트와 환경

환경 콘셉트 또는 게임 장면 한 장에 움직임을 더합니다. 생성 영상을 분위기 탐색과 팀 내부의 창작 검토에 사용할 수 있습니다.

Vidu Q4 API 키 발급과 시작 방법

세 단계로 APIMart에서 첫 Vidu Q4 영상을 만드세요.

가입하고 충전

APIMart 계정을 만들고 잔액을 충전하세요. Vidu API를 포함한 플랫폼의 모든 모델에 쓸 수 있습니다.

→

API 키 만들기

대시보드에서 API 키를 발급하세요. 같은 키로 Vidu Q4과 APIMart의 다른 모델을 호출합니다.

→

첫 요청 보내기

model을 viduq4-preview로 설정해 POST /v1/videos/generations를 호출하고, 영상이 준비될 때까지 GET /v1/tasks/{task_id}를 폴링하세요.

제작 시작

Vidu Q4 API 호출 예제: 이미지·레퍼런스로 영상 생성

APIMart에서 POST 요청 한 번으로 Vidu Q4 Preview를 호출합니다. 생성은 비동기라서 작업을 제출한 뒤 작업 API를 폴링해 영상 URL을 받습니다.

1
Vidu Q4 API 요청 인증
APIMart 키를 환경 변수 APIMART_API_KEY에 저장하고 모든 요청에 Authorization: Bearer <key>로 보내세요.
2
Vidu Q4 작업 제출
model을 viduq4-preview로 설정하고 예제처럼 소재를 넣어 POST /v1/videos/generations를 호출하세요. 작업 ID는 data[0].task_id에 있습니다.
3
Vidu Q4 영상 받기
status가 completed가 될 때까지 GET /v1/tasks/{task_id}를 폴링한 뒤 data.result.videos[0].url[0]에서 영상 URL을 읽으세요. 결과는 72시간 보관되니 제때 다운로드하세요.
모든 파라미터, 소재 규칙, 응답 필드는 Vidu Q4 Preview API 문서에서 확인하세요.

POST /v1/videos/generations

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "카메라가 천천히 다가가고 인물이 돌아보며 미소 짓는다",
    "image_urls": [
      "https://example.com/first-frame.png"
    ],
    "duration": 5,
    "resolution": "720p",
    "audio": true
  }'

import os
import time
import requests

API_BASE = "https://api.apimart.ai"
headers = {"Authorization": f"Bearer {os.environ['APIMART_API_KEY']}"}

# 1. Submit the generation task
payload = {
  "model": "viduq4-preview",
  "prompt": "카메라가 천천히 다가가고 인물이 돌아보며 미소 짓는다",
  "image_urls": [
    "https://example.com/first-frame.png"
  ],
  "duration": 5,
  "resolution": "720p",
  "audio": True
}
resp = requests.post(f"{API_BASE}/v1/videos/generations", headers=headers, json=payload, timeout=60)
resp.raise_for_status()
task_id = resp.json()["data"][0]["task_id"]

# 2. Poll the task until it finishes
for _ in range(200):
    task_resp = requests.get(f"{API_BASE}/v1/tasks/{task_id}", headers=headers, timeout=30)
    task_resp.raise_for_status()
    task = task_resp.json()["data"]
    if task["status"] == "completed":
        print(task["result"]["videos"][0]["url"][0])
        break
    if task["status"] == "failed":
        raise RuntimeError(task.get("error", {}).get("message", "generation failed"))
    time.sleep(10)
else:
    raise TimeoutError(f"task {task_id} did not finish in time; continue GET polling with this task ID")

curl -X POST https://api.apimart.ai/v1/videos/generations \
  -H "Authorization: Bearer $APIMART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "viduq4-preview",
    "prompt": "이미지 1의 인물이 해 질 녘 이미지 2의 거리를 걷는다. 자연스러운 대화와 도시 소리",
    "image_urls": [
      "https://example.com/character.png",
      "https://example.com/scene.png"
    ],
    "duration": 8,
    "resolution": "1080p",
    "aspect_ratio": "16:9"
  }'

TASK_ID="task_xxx"  # replace with the task_id returned by the POST request
curl "https://api.apimart.ai/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer $APIMART_API_KEY"

Vidu Q4 API 파라미터

파라미터	타입	필수	기본값	설명
`model`	string	필수	기본값: —	viduq4-preview를 사용합니다.
`prompt`	string	선택	기본값: —	최대 20,000자. 이미지 영상 생성은 선택, 레퍼런스 영상 생성은 필수.
`image_urls`	string[]	선택	기본값: —	공개 URL 또는 Base64 데이터 URL. 이미지 영상 생성은 1장, 레퍼런스 영상 생성은 1~15장.
`image_with_roles`	object[]	선택	기본값: —	역할이 있는 이미지: first_frame(첫 프레임) 또는 레퍼런스 영상 생성용 reference_image.
`first_frame_image`	string	선택	기본값: —	이미지 영상 생성의 첫 프레임 전용. 다른 이미지나 오디오와 함께 넣지 마세요.
`audio_urls`	string[]	선택	기본값: —	레퍼런스 영상 생성 전용. MP3 참고 오디오 최대 3개, 각 3~12초.
`duration`	integer	선택	기본값: 5	영상 길이(초): 3~16. 기본값 5.
`resolution`	string	선택	기본값: 720p	출력 해상도: 540p, 720p, 1080p, 2K, 4K. 기본값 720p.
`aspect_ratio`	string	선택	기본값: 16:9	레퍼런스 영상 생성에서 1:1, 9:16, 16:9, 3:4, 4:3. 기본값 16:9, 이미지 영상 생성에서는 무시됩니다.
`audio`	boolean	선택	기본값: true	대사와 효과음을 생성합니다. 기본값 true, false면 무음 영상입니다.
`seed`	integer	선택	기본값: —	무작위성을 제어하는 정수 seed입니다. 생략하면 무작위로 정해집니다.

Vidu API 모델 비교

APIMart의 모든 Vidu 비디오 모델을 비교하세요. API 키 하나로 전체 모델을 호출하며 영상 초 단위로 과금됩니다.

모델	추천 용도	해상도	길이
Vidu Q4 Preview API현재 페이지	최신 세대: 첫 프레임 애니메이션, 또는 참조 이미지 1–15장과 최대 3개의 오디오 클립 조합	540p – 4K	3–16초
Vidu Q3 Pro API	텍스트·이미지 영상 생성과 첫·끝 프레임, 오디오 기본 포함	540p / 720p / 1080p	1–16초
Vidu Q3 Turbo API	Vidu Q3 Pro와 같은 모드를 Vidu 시리즈 최저 초당 가격으로	540p / 720p / 1080p	1–16초
Vidu Q3 API	참조 이미지 1–7장으로 만드는 일상용 영상, 스마트한 멀티 앵글 카메라 전환	540p / 720p / 1080p	3–16초
Vidu Q3 Mix API	참조 이미지 1–7장으로 만드는 프리미엄 영상, 더 강한 스마트 트랜지션과 짧은 모션 효과	720p / 1080p	1–16초

Vidu Q4 Preview API FAQ

입력, 설정, 요금 및 결과 처리

Vidu Q4 Preview는 무엇인가요?

Vidu Q4 Preview는 ShengShu가 APIMart에서 제공하는 최신 비두(Vidu) 영상 모델로, Vidu Q4, viduq4, Vidu AI Q4로도 검색됩니다. API ID는 viduq4-preview입니다. 첫 프레임 1장을 움직이거나 레퍼런스 이미지 1~15장(참고 오디오 선택)을 따라 3~16초, 최대 4K 영상을 출력합니다.

Vidu Q4 출시일은 언제인가요?

ShengShu는 2026년 10월 7일 Vidu Q4 Preview를 출시했으며, Vidu Q4 정식 버전의 출시일은 아직 발표되지 않았습니다. APIMart의 Vidu Q4 API는 model ID viduq4-preview로 Vidu Q4 Preview를 호출합니다.

Vidu Q4 Preview와 Vidu Q4 API는 같은 건가요?

네. Vidu Q4 Preview는 현재 사용할 수 있는 Vidu Q4 버전이며, APIMart의 Vidu Q4 API는 model ID viduq4-preview로 이를 호출합니다. model ID는 표기 그대로 소문자로 입력하세요.

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

지원하지 않습니다. viduq4-preview에는 이미지가 필요합니다. I2V는 첫 프레임 1장, R2V는 참조 이미지 1–15장을 사용하며 R2V에는 참조 오디오를 최대 3개 추가할 수 있습니다. 텍스트 전용 생성과 시작·마지막 프레임 제어는 지원하지 않습니다.

첫 프레임과 참조 입력을 어떻게 선택하나요?

first_frame_image 또는 first_frame 역할은 I2V로 처리합니다. 역할 없는 이미지 1장에 참조 오디오가 없어도 I2V입니다. reference_image 역할(별칭 reference), 여러 이미지, 또는 역할 없는 이미지와 참조 오디오를 함께 쓰면 R2V입니다. 명시적 첫 프레임은 참조 이미지·오디오와 섞을 수 없습니다. image_urls와 image_with_roles의 참조 이미지는 합계 15장까지입니다. PNG, JPEG/JPG, WEBP는 장당 50 MB 이하이며 Base64 요청은 20 MB 미만이어야 합니다.

프롬프트가 필수인가요?

I2V에서는 프롬프트가 선택 사항이고 R2V에서는 필수이며, 두 모드 모두 최대 20,000자입니다. 원하는 동작, 장면, 참조 소재의 활용 방식을 설명하세요.

Vidu Q4 영상의 최대 길이는 몇 초이고, 어떤 해상도를 지원하나요?

Vidu Q4 Preview 영상의 최대 길이는 16초입니다. 길이는 3–16초 정수(기본 5초)이며, 해상도는 540p, 720p, 1080p, 2K, 4K(기본 720p)입니다. R2V 화면비는 1:1, 9:16, 16:9, 3:4, 4:3이며 기본은 16:9입니다. aspect_ratio가 별칭 size보다 우선합니다. I2V는 두 필드를 무시하고 첫 프레임을 따릅니다.

오디오와 시드는 어떻게 설정하나요?

생성 음성은 기본 true이며 false이면 같은 요금으로 무음 출력합니다. R2V에는 MP3 참조 오디오 0–3개를 추가할 수 있고 각각 3–12초, 50 MB까지입니다. 형식과 길이는 상위 서비스에서 확인하며 잘못된 오디오는 작업 실패 및 환불로 이어질 수 있습니다. seed는 정수이며 생략하거나 0으로 설정하면 무작위입니다.

Vidu Q4 API 가격은 얼마인가요?

Vidu Q4는 선택한 해상도별로 출력 초 단위로 과금됩니다. 2026년 11월 4일 기준 골드 회원 가격은 초당 540p $0.0448, 720p $0.0912, 1080p $0.1024, 2K $0.1624, 4K $0.3328이며, 5초 720p 영상은 약 $0.46입니다. 오디오 유무와 관계없이 가격이 같고 레퍼런스 이미지·오디오에 추가 요금이 없습니다. 실시간 가격은 가격표에서 확인하세요.

Vidu Q4 작업이 실패해도 요금이 부과되나요?

아니요. 첫 프레임과 레퍼런스 이미지를 함께 넣거나 이미지·오디오 개수를 초과하는 등의 파라미터 오류는 제출 시 HTTP 400을 반환하며, 작업이 생성되지 않고 요금도 부과되지 않습니다. 생성 중 실패한 작업(잘못된 참고 오디오 등)은 자동으로 전액 환불됩니다.

Vidu Q4 API 키는 어떻게 발급받나요?

APIMart에 가입하고 충전한 뒤 API Keys 페이지에서 키를 만드세요. 같은 키로 Vidu Q4, Vidu Q3 시리즈, APIMart의 다른 모든 모델을 구독 없이 종량제로 호출할 수 있습니다.

완성된 영상을 어떻게 가져오나요?

POST /v1/videos/generations로 task_id를 받은 뒤 GET /v1/tasks/{task_id}를 5~10초 간격으로 조회하세요. completed 또는 failed까지 기다리고, 성공하면 data.result.videos[0].url[0]에서 영상 주소를 가져옵니다.

Vidu Q4 영상은 얼마나 보관되나요?

생성 결과는 72시간 동안 보관되므로 제때 다운로드하세요. 상태 조회가 타임아웃되어도 작업이 실패한 것은 아니므로 새로 제출하지 말고 원래 작업 ID로 계속 조회하세요.

Vidu Q4를 온라인으로 써 볼 수 있나요?

네. APIMart에 로그인해 API 키를 만들고 충전하면 이 페이지 상단 생성기에서 브라우저로 Vidu Q4 영상을 만들 수 있습니다. 플레이그라운드는 같은 API를 호출해 같은 가격으로 초 단위 과금되며, 완성된 영상은 최근 생성 목록에 표시됩니다.

Vidu Q4와 Vidu Q3 중 무엇을 써야 하나요?

최대 4K, 레퍼런스 이미지 1~15장, 참고 오디오가 필요하면 Vidu Q4를 쓰세요. Vidu Q4는 이미지가 필수이므로 텍스트 영상 생성이나 첫·끝 프레임에는 Vidu Q3 Pro/Q3 Turbo를 쓰세요. 레퍼런스 이미지 1~7장으로 영상을 만들 때 Vidu Q3는 초당 가격이 Vidu Q4보다 낮고, Vidu Q3 Mix는 최소 1초 영상을 지원합니다.

Vidu Q4 vs Seedance 2.5 vs Kling 4.0: 어떤 모델을 골라야 하나요?

첫 프레임 1장이나 최대 15장의 레퍼런스 이미지로 최대 4K 영상을 만들려면 Vidu Q4가 맞습니다. 2026년 11월 5일 기준 골드 회원 가격은 720p 초당 $0.0912이지만, 텍스트 영상 생성은 지원하지 않고 길이는 최대 16초입니다. 최대 1080p로 최장 30초, 텍스트 영상 생성, 영상 편집·연장, 최대 50개의 레퍼런스가 필요하면 Seedance 2.5를 쓰세요. 720p 또는 1080p로 3~30초 영상을 항상 스테레오 오디오와 함께 만들고 편집·연장도 하려면 Kling 4.0이 맞습니다. Seedance 2.5와 Kling 4.0 가격은 각 모델 페이지에서 확인하세요.