Vidu โ
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask
Vidu Image q2 is an image generation model that supports text-to-image and reference-image generation.
Basic information โ
| Item | Value |
|---|---|
| ModelName | Vidu |
| ModelVersion | q2 |
| Default | ModelVersion=q2 / AspectRatio=1:1 |
| Guardrail bypass support | Supported |
Supported specs by version โ
| Version | Output specs | Input and conditions |
|---|---|---|
| Common | Ratios: 1:1 / 16:9 / 9:16 / 4:3 / 3:4Versions: VOD q2; MPS q2 / q2-pro | โ |
Request parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
ModelName | Required | String | Fixed value Vidu |
ModelVersion | Optional | String | q2 |
Prompt | Required | String | The generation prompt |
FileInfos.N | Optional | Array | Reference image (image-to-image). Category is Image |
OutputConfig.AspectRatio | Optional | String | 1:1 / 16:9 / 9:16 / 4:3 / 3:4, and so on |
OutputConfig.OutputImageCount | Optional | Integer | Number of images to generate (the upper limit differs by model) |
Request examples โ
json
{
"SubAppId": 123456789,
"ModelName": "Vidu",
"ModelVersion": "q2",
"Prompt": "a serene japanese garden, soft morning light",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001"
}Reference image request โ
json
{
"SubAppId": 123456789,
"ModelName": "Vidu",
"ModelVersion": "q2",
"Prompt": "Change the background to a quiet garden; preserve the subject.",
"OutputConfig": {
"AspectRatio": "1:1",
"OutputImageCount": 1,
"StorageMode": "Temporary"
},
"SessionContext": "job-001",
"FileInfos": [
{
"Type": "Url",
"Category": "Image",
"Url": "https://<host>/reference.jpg"
}
]
}Response example โ
json
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
"ExpireTime": "2026-08-01T10:29:48Z",
"MetaData": {
"Width": 1024,
"Height": 1024,
"Container": "png"
}
}
]
}
}
}