Vega Image โ
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask
Vega Image is WAND's in-house image generation model, supporting text-to-image and reference-image editing. It comes in Pro / Flash / Lite, and results can be checked with DescribeTaskDetail or the completion event.
Basic information โ
| Item | Value |
|---|---|
| ModelName | wand-vega-image |
| ModelVersion | 1.0-pro / 1.0-flash / 1.0-lite |
| Input | Text / reference image |
| Result lookup | DescribeTaskDetail |
| Disable guardrails support | Supported |
Supported specs by version โ
| Version | Resolution | Ratio | Reference images |
|---|---|---|---|
1.0-pro | 1K / 2K / 4K | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9 | Up to 6 |
1.0-flash | 1K / 2K / 4K | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9 | Up to 6 |
1.0-lite | 1K / 2K / 4K | 1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9 | Up to 3 |
The output size of Resolution=2K and AspectRatio=16:9 is 2560ร1440.
Reference image specification โ
| Version | Reference image count | Size per file | Format |
|---|---|---|---|
1.0-pro | Up to 6 | 10MB or less | PNG / JPEG |
1.0-flash | Up to 6 | 10MB or less | PNG / JPEG |
1.0-lite | Up to 3 | 10MB or less | PNG / JPEG |
Reference images are passed in FileInfos.Url. The size limit per file and the image count limit each apply. The reference URL must be downloadable by the generation service; for private objects, use a valid signed URL.
Generation examples โ

An illustration of a summer country road

A cyber robot appearing in the Joseon era / Pro / 2K
Request parameters โ
| Parameter | Required | Type | Description |
|---|---|---|---|
SubAppId | Required | Integer | VOD application ID |
ModelName | Required | String | wand-vega-image |
ModelVersion | Required | String | 1.0-pro / 1.0-flash / 1.0-lite |
Prompt | Conditionally required | String | Generation or editing instruction. Required if FileInfos is absent |
FileInfos.N | Optional | Array | Reference images. Type=Url / File / Base64 |
FileInfos.N.Url | Conditionally required | String | Image URL when Type=Url |
FileInfos.N.FileId | Conditionally required | String | When Type=File, the VOD media ID |
FileInfos.N.Base64 | Conditionally required | String | When Type=Base64, the image's Base64 string |
OutputConfig.Resolution | Optional | String | Output resolution |
OutputConfig.AspectRatio | Optional | String | Output ratio |
OutputConfig.StorageMode | Optional | String | Temporary / Permanent |
OutputConfig.LogoAdd | Optional | String | Logo watermark. Enabled / Disabled |
OutputConfig.OutputImageCount | Optional | Integer | Sets the number of output images for Flash / Pro. The example uses 1 |
InputRegion | Optional | String | Input region. Overseas requests are Oversea |
Request examples โ
Text-based generation โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-image",
"ModelVersion": "1.0-pro",
"Prompt": "A cybernetic robot wearing hanbok-inspired armor and a gat in a Joseon palace courtyard, rain and lantern light, cinematic realism.",
"OutputConfig": {
"StorageMode": "Temporary",
"Resolution": "2K",
"AspectRatio": "16:9",
"LogoAdd": "Disabled"
}
}Reference image editing โ
{
"SubAppId": 123456789,
"ModelName": "wand-vega-image",
"ModelVersion": "1.0-pro",
"Prompt": "Keep the person and bicycle. Change the season to autumn with warm orange foliage.",
"OutputConfig": {
"StorageMode": "Temporary",
"Resolution": "2K",
"AspectRatio": "16:9",
"LogoAdd": "Disabled",
"OutputImageCount": 1
},
"FileInfos": [
{
"Type": "Url",
"Url": ""
}
]
}Python SDK โ
import json
import os
from tencentcloud.common import credential
from tencentcloud.common.profile.client_profile import ClientProfile
from tencentcloud.common.profile.http_profile import HttpProfile
from tencentcloud.vod.v20180717 import vod_client, models
profile = ClientProfile
profile.httpProfile = HttpProfile
profile.httpProfile.endpoint = "vod.intl.tencentcloudapi.com"
client = vod_client.VodClient(
credential.Credential(
os.environ["TENCENTCLOUD_SECRET_ID"],
os.environ["TENCENTCLOUD_SECRET_KEY"],
),
"ap-singapore",
profile,
)
params = {
"SubAppId": 123456789,
"ModelName": "wand-vega-image",
"ModelVersion": "1.0-pro",
"Prompt": "A cybernetic robot in a Joseon palace courtyard, cinematic light",
"OutputConfig": {
"StorageMode": "Temporary",
"Resolution": "2K",
"AspectRatio": "16:9",
"LogoAdd": "Disabled",
},
}
request = models.CreateAigcImageTaskRequest
request.from_json_string(json.dumps(params))
response = client.CreateAigcImageTask(request)
print(response.to_json_string)Response and result lookup โ
The generation request returns TaskId.
{
"TaskId": "1500033704-AigcImageTask-b988f28b31d06c2ba1fc9ad1428c02e8t",
"RequestId": "52ee718a-4423-409e-a96c-a7797d6879b6"
}To DescribeTaskDetail, pass the same SubAppId and TaskId.
{
"SubAppId": 123456789,
"TaskId": "1500033704-AigcImageTask-b988f28b31d06c2ba1fc9ad1428c02e8t"
}When AigcImageTask.Status=FINISH and ErrCode=0, generation is complete. The image address is returned in AigcImageTask.Output.FileInfos.FileUrl.
{
"AigcImageTask": {
"Status": "FINISH",
"ErrCode": 0,
"Progress": 100,
"Output": {
"FileInfos": [
{
"FileUrl": "",
"MetaData": {
"Width": 2560,
"Height": 1440
}
}
]
}
}
}Special settings โ
Base64 reference images โ
Use the Type=Base64 and Base64 fields. JPEG / JPG / PNG / WEBP are supported, and the combined file size before encoding must be 7MB or less. The data:image/...;base64, prefix is not included.
import base64
with open("reference.png", "rb") as image:
params["FileInfos"] = [{
"Type": "Base64",
"Base64": base64.b64encode(image.read).decode("ascii"),
}]Result retention and completion events โ
StorageMode=Temporary returns a temporary result URL. To keep it as VOD media, use Permanent. Completion notifications can use either a normal callback or a trusted event notification. For the common authentication and callback specification, see API Reference.