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_KEYParameters
model string required
Model ID to use for the request
Value: viduq2_turbo_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
Note: The BGM parameter does not take effect when duration is 9 or 10 seconds
Options: true, false
Default: false
duration integer
Video duration in seconds
Options: 1 - 10
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: 540p, 720p, 1080p
Default: 720p
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
Note: Direct audio-video output function does not support off-peak mode
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
Default: 0
resolution string
Resolution parameter
viduq2-turbo (1-10 seconds): available formats 540p, 720p, 1080p
Options: 540p, 720p, 1080p
Default: 720p
movement_amplitude string
Movement amplitude of objects in the scene
Options: auto, small, medium, large
Default: auto
bgm boolean
Whether to add background music to the generated video
When true, the system will automatically add appropriate background music
Background music has no time limit, the system will automatically adjust
When Q2 model duration is 9 or 10 seconds, background music is invalid
Options: true, false
Default: false
off_peak boolean
Note: Temporarily unavailable
Off-peak mode. Off-peak mode consumes fewer points, please refer to detailed pricing information. Tasks submitted during off-peak hours will be generated within 48 hours. Unfinished tasks will be automatically cancelled and their points refunded. We also support canceling off-peak tasks
Options: true, false
Default: false
is_rec boolean
Whether to use recommended prompt
true: The system will automatically generate and apply a recommended prompt to create the video. The number of recommended prompts is 1
false: The video will be generated based on the user-provided prompt
Enabling the recommended prompt feature will consume an additional 10 points per task
Options: true, false
Default: false
Response Format
error object
Error information. Only present when status is failed.
code
integerError code
error_message
stringDetailed error message
output array
Generation results. Only present when status is completed.
content
arrayList of generated content
type
stringResource type
Value:
videourl
stringGenerated content URL
usage object
Usage statistics. Only present when status is completed.
cost
stringTotal cost in USD
discount
numberDiscount amount
metadata object
Metadata information.
Error Codes
| Error Code | Description |
|---|---|
| 008007001 | Prompt missing |
| 008007002 | Parameter invalid |
| 008007003 | Style parameter invalid |
| 008007004 | Duration invalid |
| 008007005 | Resolution invalid |
| 008007095 | Internal generation error |
| 008007096 | Result parsing error |
| 008007097 | HTTP error response |
| 008007098 | Status check error |
| 008007099 | Service unavailable |