Vidu โ
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcVideoTask
Vidu is a video generation model that supports text-to-video, first-frame / first-and-last-frame video generation, and multi-image reference generation (1โ7 images for q3-ad, 1โ14 for q3-drama). q3-mix supports multi-shot composition, and it also offers digital humans, lip sync, and effect templates, and can generate audio at the same time.
Basic Information โ
| Item | Value |
|---|---|
| ModelName | Vidu |
| ModelVersion | q3-ad / q3-drama / q3-mix / q3-turbo / q3-pro / q3 / q2-pro / q2 / q2-turbo |
| Guardrail release support | Supported |
Supported Specifications by Version โ
| Version | Resolution | Aspect Ratio | Length |
|---|---|---|---|
q3-ad | 720P / 1080P | 16:9 / 1:1 / 9:16 | โ |
q3-drama | 1080P | 16:9 / 9:16 | โ |
q3-ad | โ | โ | โ |
q3-ad | โ | โ | โ |
q3-ad | โ | โ | โ |
q3-drama | โ | โ | โ |
q3-drama | โ | โ | โ |
Input Conditions โ
| Version | Condition |
|---|---|
q3-ad | Reference image: 1โ7 images |
q3-drama | Reference image: 1โ7 images |
q3-ad | Resolution: 720PAspectRatio: 16:9Output pixels: 1280ร720 |
q3-ad | Resolution: 1080PAspectRatio: 1:1Output pixels: 1440ร1440 |
q3-ad | Resolution: 720PAspectRatio: 9:16Output pixels: 720ร1280 |
q3-drama | Resolution: 1080PAspectRatio: 16:9Output pixels: 1920ร1080 |
q3-drama | Resolution: 1080PAspectRatio: 9:16Output pixels: 1080ร1920 |
Video generation based on image references and registered reference subjects is supported. The q3 series supports automatic cut transitions and simultaneous audio generation.
Request Parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Vidu |
ModelVersion | Optional | String | q3-ad / q3-drama / q3-mix / q3-turbo / q3-pro / q3 / q2-pro / q2 / q2-turbo |
Prompt | Required | String | Generation prompt. In text input mode, write up to 2000 characters |
NegativePrompt | Optional | String | Elements to exclude from the result. Applied in supported models |
EnhancePrompt | Optional | Boolean | Automatic prompt correction. Default value false |
ImageUrl | Optional | String | First frame image URL. Must be externally accessible and no larger than 10MB |
LastImageUrl | Optional | String | Last frame image URL. Used together with ImageUrl |
ImageInfos.N | Optional | Array | Reference image array. ImageUrl / ReferenceType, etc. |
Duration | Optional | Integer | Generation length (seconds). Only the allowed values for each model are applied |
ExtraParameters | Optional | Object | Resolution / AspectRatio / EnableAudio |
AdditionalParameters | Optional | String | A JSON string containing model-specific options. For the seed delivery format, see Additional settings |
SubjectInfos.N | Optional | Array | Information about registered reference subjects. Id / Name / VoiceId / ImageUrls / VideoUrls |
SceneType | Optional | String | template_effect (effect template) |
ExtraParameters.EnablelnputComplianceCheck | Optional | Boolean | If false is explicitly passed, input moderation is released. Contact your sales representative before use |
ExtraParameters.EnableOutputComplianceCheck | Optional | Boolean | If false is explicitly passed, output moderation is released. Contact your sales representative before use |
Request Example โ
text-to-video โ
{
"ModelName": "Vidu",
"ModelVersion": "q3-pro",
"Prompt": "a paper boat drifting down a rainy street, warm lamplight",
"Duration": 5,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"EnhancePrompt": false
}Response Example โ
{
"Response": {
"Status": "DONE",
"ErrCode": "",
"Message": "ok",
"Resolution": "1280x720",
"VideoUrls": [
"https://example.com/output/vidu.mp4"
],
"RequestId": "7c43c2f7-ff98-45c4-9ac5-5742367c1a21"
}
}Special Settings โ
Guardrail Release โ
Input and output moderation can be configured separately.
To use the guardrail release parameter, you must first contact your sales representative to confirm usage permission. Even on supported engines, the guardrail release is applied only when the parameter is explicitly passed. If the parameter is omitted, it is not released.
| Parameter | Release Value | Applied To |
|---|---|---|
ExtraParameters.EnablelnputComplianceCheck | false | Input moderation release |
ExtraParameters.EnableOutputComplianceCheck | false | Output moderation release |
Merge the following settings into an existing generation request. To release both input and output moderation, pass both fields together.
{
"ExtraParameters": {
"EnablelnputComplianceCheck": false,
"EnableOutputComplianceCheck": false
}
}Supported Capabilities by Version โ
| Version | Feature |
|---|---|
q3-mix | High screen completeness with support for automatic cut transitions and simultaneous audio generation. Dedicated to reference-based generation |
q3-turbo | Automatic cut transitions, simultaneous audio generation, fastest generation speed |
q3-pro | High-quality results with audio |
q3 | Automatic cut transitions, simultaneous audio generation, multi-angle scene composition |
q2-pro | Supports reference video, video editing, and video replacement |
q2 / q2-turbo | Dynamic motion and detail expression |
Supported Modes โ
| Mode | Description | Supported Version |
|---|---|---|
| text-to-video | Generates from a prompt only. Up to 5000 characters | q3-turbo / q3-pro / q2 |
| image-to-video | Uses image 1 image as the first frame | q3-turbo / q3-pro / q2-pro / q2-turbo |
| First / Last Frame | Uses image 2 images as the first and last frames | q3-turbo / q3-pro / q2-pro / q2-turbo |
| Reference generation (general image) | Maintains the same subject across multiple images | q3-ad / q3-drama / q3-mix / q3-turbo / q3 / q2-pro / q2 |
| Reference generation (reference subject) | Creates a reference subject ID and references it with @reference subject id | q3-turbo / q3 / q2-pro / q2 (video reference subject is q2-pro only) |
Reference Image Generation โ
Specify the reference image in ImageInfos.ImageUrl.
{
"ModelName": "Vidu",
"ModelVersion": "q3-ad",
"Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
"ImageInfos": [
{
"ImageUrl": "https://example.com/reference.jpg"
}
],
"Duration": 3,
"ExtraParameters": {
"Resolution": "720P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-seoul",
"CosBucketPath": "/aigc/video/"
},
"Operator": "app"
}{
"ModelName": "Vidu",
"ModelVersion": "q3-drama",
"Prompt": "The red car moves slowly along the street. Smooth continuous camera movement.",
"ImageInfos": [
{
"ImageUrl": "https://example.com/reference.jpg"
}
],
"Duration": 12,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9",
"EnableAudio": true
},
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-seoul",
"CosBucketPath": "/aigc/video/"
},
"Operator": "app"
}Additional Options โ
Length Range
q3-ad is 3โ16 seconds. q3-drama is 8โ12 seconds. Enter reference images as ImageInfos.ImageUrl with a maximum of 7 images. The q2 series is 1โ10 seconds. Write Prompt in 2000 characters or fewer.