Skip to main content
POST
https://api.novita.ai
/
v3
/
async
/
vidu-q2-template2video
VIDU Q2 Template to Video
curl --request POST \
  --url https://api.novita.ai/v3/async/vidu-q2-template2video \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "bgm": true,
  "area": "<string>",
  "seed": 123,
  "beast": "<string>",
  "images": [
    {}
  ],
  "prompt": "<string>",
  "wm_url": "<string>",
  "payload": "<string>",
  "template": "<string>",
  "meta_data": "<string>",
  "watermark": true,
  "wm_position": 123,
  "aspect_ratio": "<string>"
}
'
{
  "task_id": "<string>",
  "provider_request_id": "<string>"
}
VIDU Q2 template to video API, supports various effect scene templates, generates effect video content based on templates and input images.
This is an asynchronous API; only the task_id will be returned. You should use the task_id to request the Task Result API to retrieve the video generation results.

​
Request Headers

​
Content-Type
string
required
Supports: application/json
​
Authorization
string
required
Bearer authentication format, for example: Bearer {{API Key}}.

​
Request Body

​
bgm
boolean
default:false
Whether to add background music to the generated video. Default: false. When true, the system will automatically select appropriate music from the preset BGM library and add it; when not passed or false, no BGM is added. BGM duration is unlimited, the system automatically adapts to video duration
​
area
string
default:"auto"
Exotic princess effect exclusive parameter. Only available when template is exotic_princess. Default: autoOptional values: auto, denmark, uk, africa, china, mexico, switzerland, russia, italy, korea, thailand, india, japan
​
seed
integer
default:0
Random seed. When not passed or passed as 0, a random number will be used instead; manually set to use the specified seed
​
beast
string
default:"auto"
Beast companion effect exclusive parameter. Only available when template is beast_companion. Default: autoOptional values: auto, bear, tiger, elk, snake, lion, wolf
​
images
array
required
Input image list. The model will generate video based on the images passed in this parameter. Supports image Base64 encoding or image URL (ensure accessibility). Supports png, jpeg, jpg, webp formats. Image aspect ratio must be less than 1:4 or 4:1, size not exceeding 50MB. Base64 decoded byte length must be less than 10M, and encoding must include appropriate content type string, e.g.: data:image/png;base64,Array length: 1 - unlimited
​
prompt
string
Text prompt, text description for generating video. Note: When template=subject_3 or pubg_winner_hit, prompt is not required
​
wm_url
string
Watermark content, image URL. When not passed, default watermark is used: content generated by AI
​
payload
string
Passthrough parameter, no processing, data transmission only. Maximum 1048576 charactersLength limit: 0 - 1048576
​
template
string
required
Scene template parameter. Different scene templates correspond to different call parameters. Common templates: subject_3 (character costume change), pubg_winner_hit (PUBG effect), exotic_princess (exotic princess), beast_companion (beast companion), etc. Please refer to https://platform.vidu.cn/docs/templates for details
​
meta_data
string
Metadata identifier, JSON format string, passthrough field. You can customize the format or use the example format. When this parameter is empty, the metadata identifier generated by vidu is used by default. Example format:
{
  "Label": "your_label",
  "ContentProducer": "your_content_producer",
  "ContentPropagator": "your_content_propagator",
  "ProduceID": "your_product_id",
  "PropagateID": "your_propagate_id",
  "ReservedCode1": "your_reserved_code1",
  "ReservedCode2": "your_reserved_code2"
}
​
watermark
boolean
default:false
Whether to add watermark. true: add watermark; false: do not add watermark. Currently watermark content is fixed, content generated by AI, not added by default. You can query watermarked video content via watermarked_url parameter
​
wm_position
integer
default:3
Watermark position, indicates where the watermark appears in the image. 1: top-left; 2: top-right; 3: bottom-right; 4: bottom-left. Default is 3Optional values: 1, 2, 3, 4
​
aspect_ratio
string
default:"16:9"
Video aspect ratio. Default 16:9, options: 16:9, 9:16. Different templates support different options, see template description for detailsOptional values: 16:9, 9:16

​
Response

​
task_id
string
required
Use the task_id to request the Task Result API to retrieve the generated outputs.
​
provider_request_id
string
Provider request ID (optional)