主题模式

腾讯云 图像生成 API 文档 ​

请求格式 ​

图像生成 API 支持 OpenAI 标准格式（推荐），同时也支持嵌套格式。嵌套格式的详细说明请参见文档末尾。

模型支持的参数 ​

腾讯图像生成模型 ​

参数说明 ​

参数名类型必填说明默认值取值范围/格式
modelstring是模型编码-腾讯图像生成模型编码
promptstring是文本描述。算法将根据输入的文本智能生成与之相关的图像。不能为空，推荐使用中文-最多可传 8192 个 utf-8 字符。示例：雨中, 竹林, 小路
negative_promptstring否反向提示词，用来描述不希望在画面中看到的内容，可以对画面进行限制-支持中英文，建议不超过 500 个字符。示例：低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等
imagesarray of string否垫图 url 列表-base64 后大小不超过 10MB，支持 jpg、jpeg、png、webp 格式，最多 3 张图。示例：["https://xxx.jpeg"]
resolutionstring否生成图分辨率1024:1024宽高维度均在 [512, 2048] 像素范围内；宽高乘积（即图像面积）不超过 1024×1024 像素。示例：1024:1024
seedinteger否随机种子随机必须大于 0。不传：随机种子生成。传正数：固定种子生成。扩写开启时固定种子不生效，将保持随机。示例：148237123
logo_addinteger否为生成结果图添加显式水印标识的开关11：添加。0：不添加。其他数值默认按 1 处理。建议使用显著标识提示结果图使用了 AI 绘画技术。示例：1
logo_paramobject否标识内容设置（LogoParam）-默认在生成结果图右下角添加「图片由 AI 生成」字样，可根据需要替换为其他标识图片
reviseinteger否是否开启 prompt 改写；为空时默认开启，改写预计会增加 20s 左右耗时开启0：关闭改写。1：开启改写。建议默认开启；若关闭改写需调用方自行接入改写，否则对生图效果有较大影响。示例：1
providerobject否调度配置参数-对象类型，包含图像生成特有参数和服务商调度参数。详细说明请参考：服务商调度参数说明

请求示例 ​

json
{
  "model": "HunyuanImage-3.0",
  "prompt": "雨中, 竹林, 小路",
  "negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等",
  "resolution": "1024:1024",
  "seed": 148237123,
  "logo_add": 1,
  "revise": 1,
  "provider": {
    "enable_image_base64": false,
    "enable_image_origin_data": true
  }
}

带垫图示例：

json
{
  "model": "HunyuanImage-3.0",
  "prompt": "雨中, 竹林, 小路",
  "images": ["https://xxx.jpeg"],
  "resolution": "1024:1024",
  "logo_add": 1,
  "revise": 1
}

响应示例 ​

模型返回标准化的响应格式，示例如下：

json
{
  "created": 1736123456,
  "data": [
    {
      "url": "https://xxx.cos.ap-guangzhou.myqcloud.com/xxx.png",
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA..."
    }
  ],
  "usage": {
    "total_tokens": 0,
    "input_tokens": 0,
    "output_tokens": 0,
    "image_count": 1
  },
  "provider": "腾讯",
  "model": "HunyuanImage-3.0",
  "origin_data": { ... }
}

说明：

  • data[].b64_json 字段：仅在 provider.enable_image_base64 设置为 true 时返回
  • origin_data 字段：可通过设置 provider.enable_image_origin_data: true 在响应中查看服务商返回的原始数据

响应参数说明 ​

成功响应 ​

参数名类型必填说明取值范围/格式
createdinteger是请求创建时间，Unix 时间戳（秒）Unix 时间戳（秒）
dataarray是生成的图片列表数组对象，每个元素包含 url、可选 b64_json
data[].urlstring是图片链接URL 字符串
data[].b64_jsonstring否图像的 Base64 编码（需请求中开启 provider.enable_image_base64）Base64 字符串
usageobject是使用情况统计含 total_tokens、input_tokens、output_tokens、image_count 等
providerstring是实际使用的服务商名称如 "腾讯"
modelstring是实际使用的模型名称字符串
origin_dataobject否服务商原始响应（需请求中开启 provider.enable_image_origin_data）对象

错误响应 ​

当 API 调用失败时，会返回错误信息。

错误响应示例：

json
{
  "error": {
    "code": "invalid_request_error",
    "message": "参数错误"
  }
}

注意事项 ​

  1. prompt：不能为空，推荐使用中文，最多 8192 个 utf-8 字符。
  2. 垫图：images 为 url 列表，单图 base64 后不超过 10MB，支持 jpg、jpeg、png、webp，最多 3 张。
  3. 分辨率：宽高在 [512, 2048] 内，面积不超过 1024×1024，默认 1024:1024。
  4. 随机种子：必须大于 0；不传为随机；传正数为固定种子；开启扩写时固定种子不生效。
  5. 水印：logo_add 默认为 1（添加），建议保留以标识为 AI 生成图片。
  6. 改写：revise 为空时默认开启；关闭改写需自行接入改写逻辑，否则影响生图效果；开启改写约增加 20s 耗时。
  7. 服务商调度参数：provider 的完整说明请参考 服务商调度参数说明。

嵌套格式（备选） ​

除 OpenAI 标准格式外，也支持嵌套格式：

  • 放入 input 的参数：prompt、negative_prompt、images 等输入相关参数
  • 放入 extra_body 的参数：resolution、seed、logo_add、logo_param、revise 及 provider 等

嵌套格式示例 ​

json
{
  "model": "HunyuanImage-3.0",
  "input": {
    "prompt": "雨中, 竹林, 小路",
    "negative_prompt": "低分辨率、错误、最差质量、低质量、残缺、多余的手指、比例不良等",
    "images": ["https://xxx.jpeg"]
  },
  "extra_body": {
    "resolution": "1024:1024",
    "seed": 148237123,
    "logo_add": 1,
    "revise": 1,
    "provider": {
      "enable_image_origin_data": true
    }
  }
}

注意：嵌套格式与 OpenAI 标准格式功能等价，推荐使用标准格式以获得更好兼容性。