Skip to content

Vidu โ€‹

Updated

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 โ€‹

ItemValue
ModelNameVidu
ModelVersionq2
DefaultModelVersion=q2 / AspectRatio=1:1
Guardrail bypass supportSupported

Supported specs by version โ€‹

VersionOutput specsInput and conditions
CommonRatios: 1:1 / 16:9 / 9:16 / 4:3 / 3:4
Versions: VOD q2; MPS q2 / q2-pro
โ€”

Request parameters โ€‹

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Vidu
ModelVersionOptionalStringq2
PromptRequiredStringThe generation prompt
FileInfos.NOptionalArrayReference image (image-to-image). Category is Image
OutputConfig.AspectRatioOptionalString1:1 / 16:9 / 9:16 / 4:3 / 3:4, and so on
OutputConfig.OutputImageCountOptionalIntegerNumber 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"
          }
        }
      ]
    }
  }
}

Built with VitePress ยท Deployed on Tencent EdgeOne Pages