Skip to main content
POST
cURL

Body

application/json
aspect_ratio
string
audio
boolean

직접 오디오-비디오 생성 기능 활성화 (q3 모델의 기본값은 참)

audio_type
enum<string>

오디오가 참일 때 오디오 유형: all (음향 효과 + 보컬), speech_only, sound_effect_only. q3 모델에는 효과 없음

Available options:
all,
speech_only,
sound_effect_only
bgm
boolean

생성된 비디오에 배경 음악 추가 (q3 모델에는 효과 없음)

callback_url
string

작업 상태 업데이트를 위한 콜백 URL

duration
integer<int32>

비디오 지속 시간(초). viduq3-pro: 1-16, viduq2-pro-fast: 1-10, viduq2-pro/turbo: 1-8

enhance
boolean
images
string[]

img2video용 이미지 (시작 프레임으로 1개 이미지 허용)

is_rec
boolean

권장 프롬프트 사용 (추가 10 크레딧 소모)

meta_data
string

메타데이터 식별, 사용자 정의 메타데이터를 위한 JSON 형식 문자열

model
string

모델 이름: viduq3-pro, viduq2-pro-fast, viduq2-pro, viduq2-turbo, viduq1, viduq1-classic, vidu2.0

movement_amplitude
enum<string>

프레임 내 객체의 이동 진폭 (q2, q3 모델에는 효과 없음)

Available options:
auto,
small,
medium,
large
off_peak
boolean

오프 피크 모드 (저렴한 비용, 48시간 내 작업 생성)

payload
string

투명 전송 파라미터 (최대 1048576자)

priority
integer<int32>
prompt
string

비디오 생성을 위한 텍스트 프롬프트 (최대 2000자)

resolution
string

해상도: 360p, 540p, 720p, 1080p, 2K (사용 가능 여부는 모델 및 기간에 따라 다름)

seed
integer<int32>

랜덤 시드 (지정하지 않으면 랜덤 기본값)

style
enum<string>
Available options:
general,
anime
voice_id
string

오디오용 음성 ID (q3 모델에는 효과 없음)

watermark
boolean

비디오에 워터마크 추가 (기본값 거짓)

wm_position
integer<int32>

워터마크 위치: 1 (좌측 상단), 2 (우측 상단), 3 (우측 하단, 기본값), 4 (좌측 하단)

wm_url
string

워터마크 이미지 URL (제공되지 않으면 기본 워터마크 사용)

Response

성공

credits
integer<int32>
required
state
enum<string>
required
Available options:
created,
processing,
queueing,
success,
failed
task_id
string
required
aspect_ratio
string
bgm
boolean

배경 음악 추가 여부

created_at
string<date-time>
duration
integer<int32>
images
string[]
model
string
movement_amplitude
enum<string>
Available options:
auto,
small,
medium,
large
off_peak
boolean

비수 모드 상태

payload
string

투명 전송 파라미터

prompt
string
resolution
string
seed
integer<int32>
style
enum<string>
Available options:
general,
anime
watermark
boolean

워터마크 추가 여부