APIMaster.ai

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.