Vidu Video Q4 Preview · API reference
Generate a video from a single image or references, then poll the APIMaster task.
Use POST /v1/wand/vidu/image-to-video for a single starting image or POST /v1/wand/vidu/reference-to-video for reference-guided generation. Poll with GET /v1/wand/vidu/tasks/{task_id}. Use JSON for submission and Bearer authentication for every request. Text-only generation and a separate start/end-frame endpoint are unavailable for this model.
| Field | Type | Description |
|---|---|---|
model |
string | Required. Use vidu-video-q4-preview. |
images |
string[] | Image-to-video requires exactly one image. Reference-to-video accepts up to 15 images or subjects. Use public URLs or data URIs in PNG, JPEG/JPG, or WebP. Aspect ratio must be 1:4 to 4:1. Each URL image can be up to 50 MB. Base64 images are limited to 15 MB before encoding and 20 MB encoded in total. |
subjects |
object[] | For reference-to-video as an alternative to images. Set each item's name and one to three images. Refer to a subject with @name in the prompt. |
prompt |
string | Required for reference-to-video. Up to 2,000 characters for direct image references or 5,000 for subjects and image-to-video. Image-to-video ignores this field when is_rec is on. |
auto_subjects |
boolean | Subject library option for reference-to-video. Defaults to false. |
audio |
boolean | Defaults to true for image-to-video and false for reference-to-video. Reference video with audio requires subjects and an explicit true value. |
audio_type |
string | When audio is enabled, use all (default), speech_only, or sound_effect_only. |
is_rec |
boolean | Automatic prompt recommendation for image-to-video. Enabling it increases task usage. |
duration |
integer | From 3 to 16 seconds, with 5 as the default. |
resolution |
string | 540p, 720p (default), 1080p, 2K, or 4K. |
aspect_ratio |
string | Reference-to-video only. Use 16:9 (default), 9:16, 3:4, 4:3, or 1:1. Image-to-video follows the input image. |
seed |
integer | Omit or set to 0 for a random seed. |
payload |
string | Optional application data, up to 1,048,576 characters. |
watermark |
boolean | Defaults to false. |
wm_url |
string | Optional custom watermark URL. The default watermark appears in the upper left. The API does not accept wm_position. |
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
-H "Authorization: Bearer $APIMASTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'
Use task_id to query with the same account every 5–10 seconds. States are created, queueing, processing, success, and failed. On success, creations[].url is the video and creations[].cover_url is its cover. Download temporary links within 12 hours. Keep request_id when reporting a failure.
Use an Idempotency-Key of 8–128 visible ASCII characters to recover a submission. The same key and parameters return a 202 recovery receipt. Different parameters with the same key return 409. See submission recovery. Query timeouts can be retried without creating a new video.
The gateway settles the generation once. tokenhub_usage.total_tokens reports billable usage. See the Vidu Video Q4 Preview model card for the current APIMaster price.
