Use this in the request body model field.
Video APIActivevidu-q3 API
Generate AI videos with strong character consistency using the Vidu Q3 API via API in One. Supports 540p–1080p, 1–16s, anime style, audio generation.
The currently implemented BFF route.
Input types: text, image
Keys are managed by the shared dashboard.
This route does not require webhook handling.
Live capabilities
These capabilities come from the current model config and backend route. Unreleased APIs are not listed.
Superior character consistency across frames
Superior character consistency across frames
Anime and general style modes
Anime and general style modes
Audio and BGM generation support
Audio and BGM generation support
Movement amplitude control for motion intensity
Movement amplitude control for motion intensity
Request format
Clients call same-origin API routes; the server BFF forwards to the matching Worker.
MethodEndpointCreditsPurpose
POST/api/v1/videos/generations300 creditsVidu Q3 by Shengshu Technology — advanced AI video generation with strong motion understanding and character consistency.
Parameters
promptstringText description of the video to generate
RequiredimagestringReference image URL for image-to-video mode
OptionalresolutionstringOutput resolution: "540p", "720p", or "1080p"
Optional · Default 720pdurationnumberVideo duration in seconds (1–16)
Optional · Default 5aspect_ratiostringAspect ratio: 16:9, 9:16, 4:3, 3:4, 1:1
OptionalstylestringVisual style: "general" or "anime"
Optional · Default generalmovement_amplitudestringMotion intensity: "auto", "small", "medium", "large"
Optional · Default autogenerate_audiobooleanGenerate audio in the video. Enabled by default; disable it to halve Q3 base pricing.
Optional · Default truebgmbooleanAdd background music
Optional · Default falseseednumberRandom seed for reproducibility
OptionalExample request
curl -X POST https://apiin.one/api/v1/videos/generations \
-H "Authorization: Bearer aio_your_api_key" \
-H "Content-Type: application/json" \
--data-raw '{
"model": "vidu-q3",
"prompt": "A woman walking through a rainy city street with neon reflections, cinematic",
"resolution": "720p",
"duration": 5,
"style": "general",
"generate_audio": true
}'Models on the same endpoint
These live models use the same implemented BFF endpoint and can be switched by changing the model field.
grok-videovideo · 24 credits/api/v1/videos/generations🎞️ltx-2video · 24 credits/api/v1/videos/generations
seedance-1-5-provideo · 28 credits/api/v1/videos/generations
hailuo-2-3video · 30 credits/api/v1/videos/generations
wan-2-6video · 80 credits/api/v1/videos/generations
pixverse-5-6video · 90 credits/api/v1/videos/generationsIntegration flow
These steps use the current live route and shared account system; login, payment, orders, credits, and profile remain shared.
Create a shared API key
Create a key in the existing dashboard. Top-up, orders, credit balance, and profile stay in the shared console.
Call the real endpoint
Send a request with the endpoint, model id, and parameters shown on this page. /api/v1/videos/generations
Poll task status
Async media and tool jobs use /api/v1/tasks/{task_id}; chat models return a direct response.
Task status route
After creating image, video, audio, or tool tasks, poll the real task endpoint for results.
GET/api/v1/tasks/{task_id}Check generation task status and result.Pricing
16–620 credits per video (~$0.16–$6.20); default 720p 5s Q3 with audio is 300 credits
Base cost$3.00
Credits300
BillingSuccessful requests
Use cases
These workflows are supported by the current model and backend node.
Create character-consistent video clips for storytelling
Generate animated scenes from reference images
Build AI video features into creative applications
Produce social media video content at scale
FAQ
How much does the Vidu Q3 API cost?
Pricing depends on resolution, model family, duration, and audio. For Q3 without audio, 540p 5s costs 70 credits, 720p 5s costs 150 credits, and 1080p 5s costs 180 credits. Audio doubles the cost; the default 720p 5s request with audio costs 300 credits.
What makes Vidu Q3 different?
Vidu Q3 excels at character consistency, anime-style generation, and supports movement amplitude control and audio/BGM generation.
Does Vidu Q3 support image-to-video?
Yes. Provide a reference image to animate into a video while preserving the subject's appearance.
What styles does Vidu Q3 support?
Vidu Q3 supports "general" and "anime" styles for different visual outputs.