Vidu Q1 - Image to Video

viduq1-img2video

Vidu Q1 I2V delivers high-quality image animation with 5-second output at 1080p, featuring smooth motion and temporal coherence.

Endpoints

POST /v1/queue/viduq1-img2video # Create task

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

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

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

Request parameters

curl --request 'POST' 'https://odirouter.ai/model/v1/queue/viduq1-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 clean studio shot of a red apple on a white table, soft natural light.",
  "style": "general",
  "seed": 42,
  "aspect_ratio": "16:9"
}'

images array required

First frame image that will be used as the starting frame for the generated video

Format Requirements:

Supports Base64 encoding or image URL (must be accessible)

Only accepts 1 image

Supported formats: png, jpeg, jpg, webp

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

Image size must not exceed 50MB

HTTP request POST body must not exceed 20MB, and encoding must include appropriate content type string. Example: data:image/png;base64,{base64_encode}

prompt string

Text description for video generation, maximum 2000 characters

If using the is_rec recommended prompt parameter, the model will not consider the prompt entered in this parameter

audio boolean

Whether to use direct audio-video output capability

When false, outputs silent video; when true, outputs video with dialogue and background sound, and the voice_id parameter takes effect

Options: true, false

Default: false

voice_id string

Voice ID to determine the voice timbre in the video, when empty, the system will automatically recommend, refer to the available voice list for options

is_rec boolean

Whether to use recommended prompts

When true, the system automatically recommends prompts and uses them to generate video; when false, generates video based on the input prompt

Note: Enabling recommended prompts consumes additional points per task

Options: true, false

Default: false

bgm boolean

Whether to add background music to the generated video

When true, the system will automatically select and add suitable music from a preset BGM library; when not provided or false, no BGM will be added

BGM duration is unlimited, the system automatically adapts to the video duration

Options: true, false

Default: false

duration integer

Video duration in seconds

Options: 5

Default: 5

seed integer

Random seed, when not provided or set to 0, uses a random number instead, manual setting uses the specified seed

resolution string

Resolution parameter

Options: 1080p

Default: 1080p

movement_amplitude string

Movement amplitude

Options: auto, small, medium, large

Default: auto

payload string

Pass-through parameter, no processing required, only data transmission, maximum 1048576 characters

off_peak boolean

Note: Temporarily unavailable

Off-peak mode, off-peak mode consumes fewer points. Tasks submitted in off-peak mode will be generated within 48 hours. Tasks that cannot be completed will be automatically canceled and points will be refunded

When true, generates video during off-peak hours; when false, generates video immediately

Options: true, false

Default: false

watermark boolean

Whether to add a watermark. When true, a watermark is added; when false, no watermark is added

Currently watermark content is fixed and AI-generated, by default no watermark is added

Options: true, false

Default: false

wm_position integer

Watermark position, indicating where the watermark appears on the image

Options: 1 (Top-left), 2 (Top-right), 3 (Bottom-right), 4 (Bottom-left)

Default: 3

wm_url string

Watermark content, provided as an image URL, when not provided, the default AI-generated watermark content is used

callback_url string

Callback URL

Response parameters

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