跳到内容

Vega Image ​

更新时间

本模型需要白名单登记。

适用对象: WAND-Vega-Image 1.0 Pro。Lite 与 Flash 无需白名单登记即可使用。

Endpoint: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations认证: Tokenhub API Key / Bearer

Vega Image 是 WAND 自研的图片生成模型,可用文本生成图片,或基于参考图进行编辑。提供 1.0 Pro / 1.0 Flash / 1.0 Lite,请求后用任务 ID 查询结果。

基本信息 ​

项目值
调用路径Tokenhub API
Pro 模型 IDwand-vega-image-pro
Flash 模型 IDwand-vega-image-flash
Lite 模型 IDwand-vega-image-lite
护栏解除支持支持

各版本支持规格 ​

版本分辨率比例参考图片
wand-vega-image-pro1K / 2K / 4K1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9最多 10 张
wand-vega-image-flash1K / 2K / 4K1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9最多 10 张
wand-vega-image-lite1K / 2K / 4K1:1 / 2:3 / 3:2 / 3:4 / 4:3 / 9:16 / 16:9 / 21:9最多 10 张

Lite 与 Flash 没有参考图片的输入费用。1.0 Pro 前 3 张 免费,从第 4 张图片开始收取输入费用。

参考图片规格 ​

版本参考图片数建议单文件容量格式
wand-vega-image-pro最多 10 张20MB 以下PNG / JPEG
wand-vega-image-flash最多 10 张20MB 以下PNG / JPEG
wand-vega-image-lite最多 10 张20MB 以下PNG / JPEG

参考图片传入 input.content.image_url。输入请按单文件 20MB 以下来构成,图片数量以整个参考数组为基准计算。参考 URL 必须能被生成服务下载,非公开对象请使用有效的签名 URL。

Tokenhub 用一个 model 指定版本。在 VOD/MPS 中,ModelName=wand-vega-image 与 ModelVersion=1.0-pro / 1.0-flash / 1.0-lite 是分开传入的。

调用流程 ​

图片生成是耗时较长的任务,因此 API 采用由以下两个阶段构成的异步调用方式。

  1. 提交任务: 调用图片生成 API。成功后会返回 task_id。
  2. 轮询结果: 在变为 status = completed 之前,使用 task_id 调用 任务结果查询 API,然后从结果中获取图片 URL。

图片生成 ​

API 说明 ​

WAND-Vega 图片生成 API 支持基于文本的图片生成与基于参考图片的生成。它基于输入的参考图片与文本提示词生成图片;若未提供图片,则执行基于文本的图片生成。

API: POST https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations

请求参数 ​

参数必填类型说明
model必填string模型 ID。wand-vega-image-pro / wand-vega-image-flash / wand-vega-image-lite
prompt必填string文本提示词,长度须在 2000 字以内。若没有参考图片,则基于这段文本生成图片。
input可选array[object]用于图片转换/参考图片场景的多模态输入内容数组。
input.content可选array[object]输入内容片段数组。按顺序拼接,构成多模态提示词。
input.content.type可选string内容类型。取值: input_image(参考图片)。
input.content.image_url可选string参考图片 URL。各版本的张数、单文件容量及格式请查看参考图片规格。
size可选string${width}x${height} 格式的输出图片尺寸。

请求示例 ​

基于文本的图片生成

bash
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wand-vega-image-pro",
  "prompt": "A detailed painting of a butterfly",
  "size": "1024x1024"
}'

基于参考图片的生成

bash
curl -X POST 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/generations' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "wand-vega-image-pro",
  "prompt": "A seamless composition of all reference images",
  "input": [
    {
      "content": [
        {
          "type": "input_image",
          "image_url": "https://mpstestmodel-1315536146.cos.ap-singapore.myqcloud.com/justin/wiki-examples/reference-cup.png"
        }
      ]
    }
  ],
  "size": "1024x1024"
}'

响应参数 ​

参数类型说明
task_idstring任务 ID。用于结果查询与回调关联。
request_idstring用于排查问题的唯一请求标识。

响应示例 ​

json
{
  "task_id": "251380669-VegaImage-f91e7435e1e34dfa9898a451946bb3d3",
  "request_id": "5b7c57a3-e5e4-4df0-958b-e72d35582be1"
}

任务结果查询 ​

查询路径 ​

查询图片生成任务的状态与结果。提交任务并拿到 task_id 后,轮询这个 API 以获取结果。

API: GET https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/tasks/<task_id>

用提交任务时返回的 task_id,以 3~5 秒 的间隔查询。

请求参数 ​

参数必填类型说明
task_id必填string提交任务时返回的 task_id 任务 ID(路径参数)。

请求示例 ​

bash
curl -X GET 'https://tokenhub-intl.tencentcloudmaas.com/v1/wand/vega-images/tasks/<task_id>' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json'

响应参数 ​

字段类型说明
statusString任务状态。参考下文的各状态处理
request_idstring用于排查问题的唯一请求标识。
dataarray[object]生成的结果列表。
data[].urlstring生成图片的下载 URL。这是含签名的临时 URL,请在有效期内下载并保存。
usageobject用量。
usage.total_tokensinteger本任务消耗的令牌数,用于计费/结算。
created_atinteger任务创建时刻。Unix timestamp(秒)。
finished_atinteger任务完成时刻。Unix timestamp(秒)。

各状态的处理 ​

状态含义处理
queued等待生成继续查询状态
in_progress生成中继续查询状态
completed生成完成从 data.url 下载图片
failed生成失败确认错误响应
cancelled已取消结束查询
incomplete以未完成状态结束确认结束原因

响应示例 ​

json
{
  "task_id": "251380669-VegaImage-68a067d14b3c43c0961ce83373709f44",
  "status": "completed",
  "request_id": "92aa30e9-7549-4319-a0eb-467302d446f5",
  "data": [
    {
      "url": "https://aigc-image.cos.myqcloud.com/xxx/result.png"
    }
  ],
  "usage": {
    "total_tokens": 16200
  },
  "created_at": 1787560807,
  "finished_at": 1787560820
}

参考输入与结果地址 ​

请在 input.content.image_url 中传入可下载的原始图片 URL。图片参考输入与素材库登记是两回事。

生成结果从 data.url 获取。返回的 COS 下载 URL 要使用含查询字符串的完整地址,并请在过期前保存文件。图片生成结果的 URL 与视频用的 asset://<id> 是不同的值。

输出尺寸 ​

size 是请求尺寸。Flash 即便在基于文本的生成中,也可能返回与请求不同尺寸·比例的图片。保存前请确认结果文件的实际宽·高与宽高比。

各比例的像素规格 ​

比例1K 分辨率2K 分辨率4K 分辨率
1:11024×1024 / 1080×10802048×2048 / 2160×21604096×4096
2:31024×1536 / 1080×16201440×21603328×4992
3:21536×1024 / 1620×10802160×14404992×3328
3:41080×14401440×1920 / 2160×28803584×4800
4:31440×10801920×1440 / 2880×21604800×3584
9:16720×1280 / 1080×19201440×25602160×3840
16:91280×720 / 1920×10802560×14403840×2160
21:91512×6482520×10805040×2160

错误码 ​

请参考 API 错误码。

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