Vidu Q3 Turbo - Image to Video

viduq3-turbo-img2video

Vidu Q3 Turbo - Image to Video provides faster generation than Vidu Q3 Pro for high-throughput video creation scenarios

Endpoints

POST /v1/queue/viduq3-turbo-img2video # Create task

GET /v1/queue/viduq3-turbo-img2video/requests/{request_id}/status # Check status

GET /v1/queue/viduq3-turbo-img2video/requests/{request_id}/response # Get result

PUT /v1/queue/viduq3-turbo-img2video/requests/{request_id}/cancel # Cancel task

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq3-turbo-img2video' \
  --header 'Authorization: Bearer YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --location \
  --data-raw '{
  "images": [
    "https://www.gstatic.com/webp/gallery/1.jpg"
  ],
  "prompt": "A cat walking slowly",
  "duration": 5,
  "resolution": "720p",
  "audio": true,
  "aspect_ratio": "16:9"
}'

images array<string> required

First-frame image input. The model uses this image as the starting frame for video generation

Note 1: Supports image Base64 or image URL (must be accessible)

Note 2: Only 1 input image is supported

Note 3: Supported formats: png, jpeg, jpg, webp

Note 4: Image aspect ratio must be less than 1:4 or 4:1

Note 5: Max image size is 50MB

Note 6: HTTP POST body must be under 20MB, and encoding must include content type, for example data:image/png;base64,{base64_encode}

prompt string

Text prompt describing the video to generate

Limit: Up to 5000 characters

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

is_rec boolean

Whether to use a recommended prompt

true: System auto-generates one recommended prompt and uses it for generation

false: Uses the provided prompt

Note: Enabling recommended prompts consumes an extra 10 credits per task

Options: true, false

Default: false

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

resolution string

Output resolution

Options: 540p, 720p, 1080p

Default: 720p

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-turbo-img2video/requests/task_01hxyz.../response",
  "status_url": "https://odirouter.ai/model/v1/queue/viduq3-turbo-img2video/requests/task_01hxyz.../status",
  "cancel_url": "https://odirouter.ai/model/v1/queue/viduq3-turbo-img2video/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