跳到内容

Vega Image HOT ​

更新时间

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

Vega Image 是 WAND 自研的图片生成模型,支持文生图与参考图编辑。提供 Pro / Flash / Lite 三个版本,生成结果通过 DescribeAigcImageTask 查询。

基本信息 ​

项目值
ModelNamewand-vega-image
ModelVersion1.0-pro / 1.0-flash / 1.0-lite
输入文本 / 参考图片 URL
结果查询DescribeAigcImageTask
结果保存StoreCosParam 中指定的 COS 存储桶
护栏解除支持支持

各版本支持规格 ​

版本分辨率比例参考图片
1.0-pro1920×108016:92 张
1.0-flash1920×108016:92 张
1.0-lite1920×108016:92 张

表格中的输出尺寸是在 AdditionalParameters 的 size 中指定 1920x1080 的配置。参考图片通过各条目的 ImageUrl 传入。

参考图片规格 ​

版本示例参考图片数量单文件推荐容量格式
1.0-pro2 张10MB 以下PNG / JPEG
1.0-flash2 张10MB 以下PNG / JPEG
1.0-lite2 张10MB 以下PNG / JPEG

参考图片通过 ImageInfos.ImageUrl 传入。表格中的 2 张 为对接示例的输入配置,不代表模型的最大张数。参考 URL 必须能被生成服务下载,私有对象请使用有效的签名 URL。

生成示例 ​

同时输入雪原背景与角色设定图,生成一个场景。第一张图片参考地点与灯光,第二张图片参考人物的脸部与服装。

参考图片 ​

图片 1 / 雪原背景

图片 1 / 雪原背景

图片 2 / 人物的脸部与服装

图片 2 / 人物的脸部与服装

Pro / Lite 生成结果 ​

Pro / 雪原中的角色

Pro / 雪原中的角色

Lite / 雪原中的角色

Lite / 雪原中的角色

两个版本使用了相同的参考图片与 Prompt。输出尺寸为 1920×1080。分别指定参考图片的作用,并请求人物单人出镜的场景,而不是角色设定图的多个视图。

请求参数 ​

参数必填类型说明
ModelName必填Stringwand-vega-image
ModelVersion必填String1.0-pro / 1.0-flash / 1.0-lite
Prompt必填String要生成的图片或参考图片的编辑指令
EnhancePrompt选填BooleanPrompt 自动校正。示例使用 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结果对象的路径前缀

请求示例 ​

基于文本的生成 ​

json
{
  "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。

json
{
  "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。

json
{
  "Response": {
    "TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258",
    "RequestId": "f81c4bfa-2311-4882-b172-2ebebbd5d8c3"
  }
}
json
{
  "TaskId": "2600012260-AigcImage-10c86f2c4eef4851814f073682902258"
}

状态为 Status=DONE 且 ImageUrls 中返回地址后,即可使用结果。

json
{
  "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高 格式的像素尺寸。

json
{
  "AdditionalParameters": "{\"size\":\"1920x1080\"}"
}

指定参考图片的作用 ​

按照 ImageInfos 的顺序,在 Prompt 中说明每张图片的作用。指定背景图片参考地点与灯光,角色图片参考脸型 / 发型 / 服装。角色设定图用于人物设定,结果中的人数与构图需另行明确。

输出文件在 Pro / Lite 下以 PNG 返回,在 Flash 下以 JPEG 返回。保存时请使用返回的文件格式与扩展名。

结果保存 ​

指定 StoreCosParam 后,生成结果将保存到相应的 COS 存储桶。私有存储桶的结果可通过 COS SDK 或签名 URL 下载。鉴权、请求执行与保存的通用规格请参考 API Reference。

基于 VitePress 构建 · 部署于腾讯云 EdgeOne Pages