Vidu Q3 Reference API for Consistent Video

Access Vidu Q3 Reference through the independent GoEnhance Open API. Supply 1–7 reference images with a prompt, submit an asynchronous video task, then poll with the returned img_uuid or receive status callbacks.
Get API Key
Cinematic lakeside scene representing reference-to-video consistency

Build a Vidu Q3 Reference API request

Reference-image input built for consistency

POST to https://api.goenhance.ai/api/v1/videos/generations with model: viduq3_reference, a required prompt, and image_urls containing 1–7 public reference images.
Unbranded character maquettes staged together for visual reference

Validated requests and asynchronous results

Validate image format, dimensions, aspect ratio, duration, resolution, and output ratio before submission. Persist img_uuid, then poll GET /api/v1/jobs/detail or use a public HTTPS callback.
Cinematic camera rig representing an asynchronous production workflow
Match the documented reference-to-video request schema before submitting a task.

Vidu Q3 Reference API capabilities and limits

Model and prompt

Set model to viduq3_reference and provide the required text prompt describing the intended video.

Reference images

Send 1–7 URLs in 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

This route accepts image_urls, not image_url or image_end_url. Use viduq3_pro for text-only, first-frame, or start-end-frame generation.

Duration

Choose an integer from 3 through 16 seconds. The documented default is 5 seconds.

Resolution

Select 540p, 720p, or 1080p. The documented default is 720p.

Output ratio

Set ratio to 16:9, 9:16, or 1:1; the documented default is 16:9. aspect_ratio is accepted as a compatible alias.
Estimate cost as the selected per-second rate multiplied by requested duration.

Vidu Q3 Reference API pricing

540p

1.75 tokens per generated second, equal to $0.035 per second at the documented $0.02-per-token rate.

720p

3 tokens per generated second, equal to $0.06 per second at the documented $0.02-per-token rate.

1080p

3.75 tokens per generated second, equal to $0.075 per second at the documented $0.02-per-token rate.

Integrate Vidu Q3 Reference in six steps

1

1. Create an API key

Create a GoEnhance key and send it as a bearer token in the Authorization header.
2

2. Prepare references

Host 1–7 compliant reference images at public URLs and decide which visual details the prompt should preserve.
3

3. Validate the request

Set viduq3_reference, a 3–16 second duration, a supported resolution, and a supported ratio.
4

4. Submit the task

POST to /api/v1/videos/generations and persist the returned img_uuid.
5

5. Track status

Poll GET /api/v1/jobs/detail or configure a public HTTPS custom_callback_url.
6

6. Handle completion

Process success and failure states idempotently, then verify the generated asset before downstream use.
Get API Key
Build repeatable reference-to-video workflows around explicit inputs and terminal task states.

Developer use cases for the Vidu Q3 Reference API

Character-led campaign clips

Carry approved fictional characters or talent references into short campaign-video concepts.

Product identity sequences

Use multiple approved product views as visual references for motion-focused creative exploration.

Story continuity

Reference recurring subjects when generating separate shots for storyboard and previsualization workflows.

Localized creative variants

Reuse approved visual references while adapting prompts for regional campaign concepts.

Style-consistent social assets

Build short-form video pipelines around a controlled set of visual references and output ratios.

Creative prototyping

Test reference combinations, prompts, durations, and resolutions before committing to a wider production workflow.
Answers to common pricing, reference-input, asynchronous-task, and ShengShu API questions.

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.

Start building with the Vidu Q3 Reference API