Vega Image HOT
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcImageTask
Vega Image 是 WAND 自研的图片生成模型,支持文生图与参考图编辑。提供 Pro / Flash / Lite 三个版本,生成结果通过 DescribeAigcImageTask 查询。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | wand-vega-image |
| ModelVersion | 1.0-pro / 1.0-flash / 1.0-lite |
| 输入 | 文本 / 参考图片 URL |
| 结果查询 | DescribeAigcImageTask |
| 结果保存 | StoreCosParam 中指定的 COS 存储桶 |
| 护栏解除支持 | 支持 |
各版本支持规格
| 版本 | 分辨率 | 比例 | 参考图片 |
|---|---|---|---|
1.0-pro | 1920×1080 | 16:9 | 2 张 |
1.0-flash | 1920×1080 | 16:9 | 2 张 |
1.0-lite | 1920×1080 | 16:9 | 2 张 |
表格中的输出尺寸是在 AdditionalParameters 的 size 中指定 1920x1080 的配置。参考图片通过各条目的 ImageUrl 传入。
参考图片规格
| 版本 | 示例参考图片数量 | 单文件推荐容量 | 格式 |
|---|---|---|---|
1.0-pro | 2 张 | 10MB 以下 | PNG / JPEG |
1.0-flash | 2 张 | 10MB 以下 | PNG / JPEG |
1.0-lite | 2 张 | 10MB 以下 | PNG / JPEG |
参考图片通过 ImageInfos.ImageUrl 传入。表格中的 2 张 为对接示例的输入配置,不代表模型的最大张数。参考 URL 必须能被生成服务下载,私有对象请使用有效的签名 URL。
生成示例
同时输入雪原背景与角色设定图,生成一个场景。第一张图片参考地点与灯光,第二张图片参考人物的脸部与服装。
参考图片

图片 1 / 雪原背景

图片 2 / 人物的脸部与服装
Pro / Lite 生成结果

Pro / 雪原中的角色

Lite / 雪原中的角色
两个版本使用了相同的参考图片与 Prompt。输出尺寸为 1920×1080。分别指定参考图片的作用,并请求人物单人出镜的场景,而不是角色设定图的多个视图。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | wand-vega-image |
ModelVersion | 必填 | String | 1.0-pro / 1.0-flash / 1.0-lite |
Prompt | 必填 | String | 要生成的图片或参考图片的编辑指令 |
EnhancePrompt | 选填 | Boolean | Prompt 自动校正。示例使用 false |
ImageInfos.N | 选填 | Array | 参考图片列表 |
ImageInfos.N.ImageUrl | 条件必填 | String | 参考图片的 HTTPS URL |
AdditionalParameters | 选填 | String | 存放模型专属选项的 JSON 字符串。通过 size 指定输出尺寸 |
StoreCosParam | 选填 | Object | 用于保存结果的 COS 存储桶与路径 |
StoreCosParam.CosBucketName | 条件必填 | String | 结果保存存储桶名称 |
StoreCosParam.CosBucketRegion | 条件必填 | String | 存储桶地域。示例:ap-singapore |
StoreCosParam.CosBucketPath | 选填 | String | 结果对象的路径前缀 |
请求示例
基于文本的生成
{
"ModelName": "wand-vega-image",
"ModelVersion": "1.0-pro",
"Prompt": "A golden retriever astronaut floating inside a spacecraft cupola window, wearing a white spacesuit and dark sunglasses, Earth visible behind the glass, cinematic lighting.",
"EnhancePrompt": false,
"AdditionalParameters": "{\"size\":\"1920x1080\"}",
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-singapore",
"CosBucketPath": "/vega/"
}
}用参考图片构建场景
下面的请求即为上述 Pro 结果所使用的 Prompt 与参考配置。Lite 将 ModelVersion 指定为 1.0-lite。
{
"ModelName": "wand-vega-image",
"ModelVersion": "1.0-pro",
"Prompt": "Use reference image 1 as the snowy forest location and reference image 2 only as the identity and outfit reference for one adult woman. Create ONE cinematic photograph, not a character sheet or collage. The same woman stands on the snowy path, framed from mid-thigh up, slightly left of center, looking back toward camera with a quiet thoughtful expression. Preserve her face, short layered dark hair, lavender zip-up track jacket with cream sleeve stripes, white inner shirt, striped gray trousers, small hoop earrings and delicate necklace. Preserve the forest's snow-laden conifers, rocky mountains and blue winter light. Add natural cold breath and a few drifting snowflakes. Realistic skin texture, believable feet/body placement and contact shadows, coherent lighting and perspective, soft backlight, subtle cinematic depth of field, premium film still, no text, no logos, no duplicated people.",
"EnhancePrompt": false,
"ImageInfos": [
{
"ImageUrl": ""
},
{
"ImageUrl": ""
}
],
"AdditionalParameters": "{\"size\": \"1920x1080\"}",
"StoreCosParam": {
"CosBucketName": "example-1250000000",
"CosBucketRegion": "ap-singapore",
"CosBucketPath": "/vega/"
}
}响应与结果查询
生成请求会返回 TaskId。向 DescribeAigcImageTask 传入相同的 TaskId。
{
"Response": {
"TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258",
"RequestId": "f81c4bfa-2311-4882-b172-2ebebbd5d8c3"
}
}{
"TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258"
}状态为 Status=DONE 且 ImageUrls 中返回地址后,即可使用结果。
{
"Response": {
"Status": "DONE",
"Message": "ok",
"ImageUrls": [
"https://example-1250000000.cos.ap-singapore.myqcloud.com/vega/result.png"
],
"RequestId": "f81c4bfa-2311-4882-b172-2ebebbd5d8c3"
}
}特殊配置
输出尺寸
AdditionalParameters 是将 JSON 对象序列化为字符串的值。在 size 中指定 宽x高 格式的像素尺寸。
{
"AdditionalParameters": "{\"size\":\"1920x1080\"}"
}指定参考图片的作用
按照 ImageInfos 的顺序,在 Prompt 中说明每张图片的作用。指定背景图片参考地点与灯光,角色图片参考脸型 / 发型 / 服装。角色设定图用于人物设定,结果中的人数与构图需另行明确。
输出文件在 Pro / Lite 下以 PNG 返回,在 Flash 下以 JPEG 返回。保存时请使用返回的文件格式与扩展名。
结果保存
指定 StoreCosParam 后,生成结果将保存到相应的 COS 存储桶。私有存储桶的结果可通过 COS SDK 或签名 URL 下载。鉴权、请求执行与保存的通用规格请参考 API Reference。