Vidu Q3 Pro - Text to Video

viduq3-pro-text2video

Vidu Q3 Pro - Text to Video efficiently generates high-quality audio-video content with stronger motion and richer scene expression

Endpoints

POST /v1/queue/viduq3-pro-text2video # Create task

GET /v1/queue/viduq3-pro-text2video/requests/{request_id}/status # Check status

GET /v1/queue/viduq3-pro-text2video/requests/{request_id}/response # Get result

PUT /v1/queue/viduq3-pro-text2video/requests/{request_id}/cancel # Cancel task

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq3-pro-text2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "prompt": "A clean studio shot of a red apple on a white table, soft natural light.",
  "duration": 5,
  "resolution": "720p",
  "audio": true,
  "seed": 0,
  "aspect_ratio": "16:9"
}'

prompt string required

Text prompt describing the video to generate

Limit: Up to 5000 characters

duration integer

Video duration in seconds

Options: 1 - 16

Default: 5

seed integer

Random seed. If omitted or set to 0, a random seed is used automatically

aspect_ratio string

Aspect ratio of the generated video

Options: 16:9, 9:16, 3:4, 4:3, 1:1

Default: 16:9

resolution string

Output resolution

Options: 540p, 720p, 1080p

Default: 720p

audio boolean

Whether to enable direct audio-video generation

false: Outputs a silent video

true: Outputs a video with speech and background audio

Options: true, false

Default: true

payload string

Pass-through parameter for custom payload data

Limit: Up to 1048576 characters

off_peak boolean

Note: Temporarily unavailable

Off-peak generation mode

true: Off-peak generation

false: Immediate generation

Note 1: Off-peak mode consumes fewer credits

Note 2: Tasks are processed within 48 hours, unfinished tasks are auto-canceled with credit refund

Note 3: You can also cancel off-peak tasks manually

Options: true, false

Default: false

watermark boolean

Whether to add a watermark

true: Add watermark

false: No watermark

Note 1: Current watermark content is fixed and AI-generated, disabled by default

Note 2: You can retrieve watermarked content via watermarked_url

Options: true, false

Default: false

wm_position integer

Watermark position in the frame

1: Top-left

2: Top-right

3: Bottom-right

4: Bottom-left

Default: 3

wm_url string

Watermark image URL. If omitted, the default AI-generated watermark is used

meta_data string

Metadata identifier in JSON string format, passed through without modification

{

"Label": "your_label",

"ContentProducer": "yourcontentproducer",

"ContentPropagator": "your_content_propagator",

"ProduceID": "yourproductid",

"PropagateID": "your_propagate_id",

"ReservedCode1": "yourreservedcode1",

"ReservedCode2": "your_reserved_code2"

}

If empty, default metadata generated by vidu is used

callback_url string

Callback URL. Set callback_url when creating the task, request method is POST

Response parameters

{
  "request_id": "task_01hxyz...",
  "response_url": "https://odirouter.ai/model/v1/queue/viduq3-pro-text2video/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/viduq3-pro-text2video/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/viduq3-pro-text2video/requests/task_01hxyz.../cancel",
  "queue_position": 0
}

Field	Type	Description
`request_id`	string	Task ID used for all follow-up operations.
`response_url`	string	URL to fetch the final result.
`status_url`	string	URL to query task status.
`cancel_url`	string	URL to cancel the task.
`queue_position`	int	Current queue position.

Follow-up operations

Check status

Get result

Cancel task

Error handling