img_uuid, then poll or receive callbacks until the job succeeds or fails.Vidu Q3 Pro API for Video Generation
Access Vidu Q3 Pro through the independent GoEnhance Open API for text-to-video, image-to-video, and start-end-frame generation. Submit one asynchronous request, persist the returned
Get API Key
Build a clear Vidu Q3 Pro API request
Three input modes on one endpoint
POST to https://api.goenhance.ai/api/v1/videos/generations with model: viduq3_pro. Use a prompt alone for text-to-video, add image_url for a first frame, or add image_end_url for start-end-frame generation.
Explicit controls and asynchronous completion
Validate duration, resolution, and text-to-video ratio before submission. Save the returned task ID, then use GET /api/v1/jobs/detail or a public HTTPS custom_callback_url to handle terminal results.
Match the documented request schema before a task enters your video pipeline.
Vidu Q3 Pro API capabilities and parameters
Model
Set <code>model</code> to <code>viduq3_pro</code>.
Prompt
Provide the required text prompt describing the intended video.
First frame
Add a public <code>image_url</code> for image-to-video generation; omit it for text-to-video.
Last frame
Add <code>image_end_url</code> together with <code>image_url</code> for start-end-frame control.
Duration
Choose an integer from 1 through 16 seconds. The documented default is 5 seconds.
Resolution and ratio
Resolution accepts 540p, 720p, or 1080p, defaulting to 720p. The <code>ratio</code> field applies to text-to-video requests.
Estimate generation cost as the selected per-second rate multiplied by the requested duration.
Vidu Q3 Pro API pricing
540p
2.25 tokens per generated second, equal to $0.045 per second at the documented $0.02-per-token rate.
720p
5 tokens per generated second, equal to $0.10 per second at the documented $0.02-per-token rate.
1080p
6 tokens per generated second, equal to $0.12 per second at the documented $0.02-per-token rate.
Integrate Vidu Q3 Pro 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. Select the input mode
Use a prompt alone, add a first-frame URL, or add both first- and last-frame URLs.
3
3. Validate the request
Set
viduq3_pro, a 1–16 second duration, and one of the documented resolution values. 4
4. Submit the video 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 callback URL. 6
6. Handle completion
Process success and failure states idempotently, and verify the returned asset before downstream use.
Build repeatable video-generation workflows around explicit inputs and terminal task states.
Developer use cases for the Vidu Q3 Pro API
Campaign video variants
Generate short concept clips from structured prompts for creative review and downstream assembly.
Product motion
Animate an approved product frame while your application controls prompts, validation, and asset review.
Storyboard transitions
Use first- and last-frame inputs to explore motion between two approved visual beats.
Localized creative pipelines
Parameterize prompts for regional campaign variants without changing the asynchronous task handler.
Social video production
Create brief motion assets at a resolution and duration selected by your application.
Previsualization
Turn concise shot descriptions into reviewable motion concepts before full production.
Answers to common pricing, input, task-status, and ShengShu video API questions.