참조-투-비디오 작업 생성(비주체)
- Official docs: https://platform.vidu.cn/docs/reference-to-video
- Create reference-to-video task without subject invocation; returns task_id or details
- Control generation with request parameters
Authorizations
Request Body
Text prompt for video generation.
Note: Max 5000 characters
Model name. Allowed: viduq3-mix, viduq3, viduq2-pro, viduq2, viduq1, vidu2.0
- viduq3-mix: Strong quality, smart cuts, audio-video sync, best balance
- viduq3: Smart cuts, audio-video sync, multi-camera consistency
- viduq2-pro: Reference video, edit, replace
- viduq2: Strong motion, rich detail
- viduq1: Clear visuals, smooth transitions
- vidu2.0: Fast generation
Duration by model
viduq3-mix: default 5s, 1–16
viduq3: default 5s, 3–16
viduq2-pro, viduq2: default 5s, 1–10
viduq1: default 5s, 5 only
vidu2.0: default 4s, 4 only
Random seed
If omitted or 0, random; else uses set value
Motion amplitude, default auto; auto, small, medium, large
Note: Not supported on q2, q3 models
Passthrough parameter
Not processed; data transfer only
Note: Max 1048576 characters
Add watermark: true / false
Note 1: Fixed AI watermark; off by default
Note 2: Use watermarked_url from query API
Watermark position: 1 top-left, 2 top-right, 3 bottom-right, 4 bottom-left. Default 3
Watermark image URL; default AI-generated text if omitted
Metadata JSON (passthrough). Example keys in docs. If empty, Vidu default metadata
Callback URL (POST). Status: processing, success (retry x3), failed (retry x3). Signature auth
Audio-video output, default true
- false: silent video
- true: synced audio video
Note: Without subject, only q3 supports this
Aspect ratio; q2, q3 support auto
Default 16:9; 1:1, 9:16, 16:9, 3:4, 4:3, auto
Resolution by model:
viduq3-mix (1–16s): default 720p; 720p, 1080p
viduq3 (3–16s): default 720p; 540p, 720p, 1080p
viduq2-pro, viduq2 (1–10s): default 720p; 540p, 720p, 1080p
viduq1 (5s): 1080p
vidu2.0 (4s): 360p; 360p, 720p
Image references (1–7 depending on model)
Note 1–6: Base64/URL, formats, size, POST body 20 MB limit
data:image/png;base64,{base64_encode}
Video references (1–2); viduq2-pro only
Note: 1×8s or 2×5s; mp4, avi, mov; size limits apply
Audio references (reserved; not supported yet)
Background music, default false
true: pick from BGM library
Not effective on some q2/q3 duration settings
Responses
성공