Skip to content

Qwen ​

Updated

Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask

Qwen Image is an image generation model that supports text-to-image and reference-image generation, with output sizes from 512×512 to 2048×2048.

Basic information ​

ItemValue
ModelNameQwen
ModelVersion0925
DefaultModelVersion=0925 / AspectRatio=1:1
Disable guardrails supportNot supported

Supported specs by version ​

VersionOutput specInput and conditions
CommonRatios: 1:1 / 16:9 / 9:16 / 4:3 / 3:4
Custom size: VOD size: 512²–2048² range. MPS uses the example value for that path
—

Request parameters ​

ParameterRequiredTypeDescription
ModelNameRequiredStringFixed value Qwen
ModelVersionOptionalString0925
PromptRequiredStringGeneration prompt
FileInfos.NOptionalArrayReference image (image-to-image). Category is Image
OutputConfig.AspectRatioOptionalString1:1 / 16:9 / 9:16 / 4:3 / 3:4, etc.
OutputConfig.OutputImageCountOptionalIntegerNumber of images to generate (upper limit varies by model)
ExtInfoOptionalStringSpecify resolution directly via AdditionalParameters's size (512²~2048²)

Request example ​

json
{
  "SubAppId": 123456789,
  "ModelName": "Qwen",
  "ModelVersion": "0925",
  "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": "Qwen",
  "ModelVersion": "0925",
  "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