Vidu Q1 - Image to Video

Authentication

authorization string required

All APIs require authentication via Bearer Token.

Get API Key:

Visit API Key Management Page to get your API Key

Usage:

Add to request header:

Authorization: Bearer YOUR_API_KEY

Parameters

model string required

Model ID to use for the request

Value: viduq1_img2video

---

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

---

Polling

Since video generation takes time, you need to poll the task status after creation

The initial response returns the task ID and initial status. The actual generation results must be obtained through polling the task status endpoint

Response Format

error object

Error information. Only present when status is failed.

code integer

Error code

error_message string

Detailed error message

---

output array

Generation results. Only present when status is completed.

content array

List of generated content

type string

Resource type

Value: video

url string

Generated content URL

---

usage object

Usage statistics. Only present when status is completed.

cost string

Total cost in USD

discount number

Discount amount

---

metadata object

Metadata information.

---

Error Codes

Error Code	Description
0	No error
8008003001	Missing image
8008003002	Invalid parameter value
8008003003	Invalid Style
8008003004	Invalid image
8008003098	Generation failed
8008003099	Provider unavailable