img_uuid or receive status callbacks.Vidu Q3 Reference API for Consistent Video

Build a Vidu Q3 Reference API request
Reference-image input built for consistency
https://api.goenhance.ai/api/v1/videos/generations with model: viduq3_reference, a required prompt, and image_urls containing 1–7 public reference images.
Validated requests and asynchronous results
img_uuid, then poll GET /api/v1/jobs/detail or use a public HTTPS callback.
Vidu Q3 Reference API capabilities and limits
Model and prompt
model to viduq3_reference and provide the required text prompt describing the intended video.Reference images
image_urls. Each image must be PNG, JPEG, JPG, or WebP; at least 128×128 pixels; no larger than 50 MB; and between 1:4 and 4:1 aspect ratio.Dedicated input mode
image_urls, not image_url or image_end_url. Use viduq3_pro for text-only, first-frame, or start-end-frame generation.Duration
Resolution
540p, 720p, or 1080p. The documented default is 720p.Output ratio
ratio to 16:9, 9:16, or 1:1; the documented default is 16:9. aspect_ratio is accepted as a compatible alias.Vidu Q3 Reference API pricing
540p
720p
1080p
Integrate Vidu Q3 Reference in six steps
1. Create an API key
2. Prepare references
3. Validate the request
viduq3_reference, a 3–16 second duration, a supported resolution, and a supported ratio.4. Submit the task
/api/v1/videos/generations and persist the returned img_uuid.5. Track status
GET /api/v1/jobs/detail or configure a public HTTPS custom_callback_url.6. Handle completion
Developer use cases for the Vidu Q3 Reference API
Character-led campaign clips
Product identity sequences
Story continuity
Localized creative variants
Style-consistent social assets
Creative prototyping
Vidu Q3 Reference API FAQ
What is the Vidu Q3 Reference API endpoint on GoEnhance?
Submit POST https://api.goenhance.ai/api/v1/videos/generations with model set to viduq3_reference. A successful submission returns img_uuid for asynchronous tracking.
How does Vidu Q3 Reference API pricing work?
Pricing is per generated second: 1.75 tokens/s ($0.035/s) at 540p, 3 tokens/s ($0.06/s) at 720p, and 3.75 tokens/s ($0.075/s) at 1080p. Multiply the selected rate by duration.
How many reference images can I send?
The documented image_urls array requires 1–7 images. Each must meet the published format, size, dimension, and aspect-ratio limits.
Can I send image_url or image_end_url?
No. This dedicated reference route accepts image_urls. Use the separately documented viduq3_pro route for text-to-video, first-frame image-to-video, or start-end-frame generation.
Which duration, resolution, and ratio values are supported?
Duration is 3–16 seconds. Resolution supports 540p, 720p, and 1080p. Ratio supports 16:9, 9:16, and 1:1.
How do I know when the video is finished?
Persist img_uuid and poll GET /api/v1/jobs/detail, or provide a public HTTPS custom_callback_url. Non-200 callback responses are retried up to three times with a three-second timeout per attempt.
Is this the official ShengShu API?
No. Vidu is developed by ShengShu Technology. This page describes independent third-party API access through GoEnhance and does not imply affiliation, partnership, or endorsement.
How is Vidu Q3 Reference different from the Turbo reference tier?
This page covers the standard viduq3_reference route. The separately documented viduq3_turbo_reference route is the faster, lower-priced reference tier; do not mix its model identifier or pricing into this request.
