跳到内容

Hy HOT ​

更新时间

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

Hy Image 是腾讯混元的图片生成模型,支持文生图与参考图生成 / 编辑。3.5-preview 支持基于上一轮结果的多轮再编辑。

基本信息 ​

项目值
ModelNameHunyuan
ModelVersion3.5-preview / 3.0
默认值ModelVersion=3.5-preview
支持的模式文本生成、参考图片生成、产物再编辑
护栏解除支持不支持

Hy Image 不适用输入·输出护栏解除参数。

同时支持文本生成与基于参考图片的生成。

3.0 可输入参考图片 3 张,3.5-preview 可输入至 6 张。

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Hunyuan
ModelVersion可选String3.5-preview / 3.0
Prompt必填String生成提示词。若有参考图片,则作为编辑指令生效
FileInfos.N可选Array参考图片。放入 Type 与 Url
OutputConfig.Resolution可选String1K / 2K / 4K
OutputConfig.AspectRatio可选String1:1 / 16:9 / 9:16 / 4:3 等
OutputConfig.PersonGeneration可选StringAllowAdult / Disallowed
ExtInfo可选String直接指定像素尺寸。请参考下文条目

每个请求的输出图片

3.5-preview 每个请求生成 1 张 图片。多张请按顺序提交请求。

请求示例 ​

这是文本生成。

json
{
  "SubAppId": 123456789,
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "Resolution": "2K",
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

这是基于参考图片的生成。放入参考图片后,Prompt 会被解释为编辑指令。

json
{
  "SubAppId": 123456789,
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "change the car color to matte black, keep the composition",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/car.png"
    }
  ],
  "OutputConfig": {
    "Resolution": "1K",
    "AspectRatio": "16:9",
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

响应示例 ​

json
{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "https://store.vod-qcloud.com/.../aigcImageGenFile.png",
          "ExpireTime": "2026-10-02T07:59:41Z",
          "MetaData": {
            "Width": 2048,
            "Height": 1152,
            "Container": "png_pipe"
          }
        }
      ]
    }
  }
}

特殊设置 ​

输出分辨率 ​

这是 Resolution 与 AspectRatio 组合所对应的实际输出像素。取值会对齐到 16 的倍数。

Resolution1:116:99:164:33:4
省略720x7201280x720720x1280960x720720x960
1K1024x10241808x10241024x18081360x10241024x1360
2K2048x20482048x11521152x20481920x14401440x1920
4K4096x40963840x21602160x38403840x28802880x3840

省略 Resolution 而只放入 AspectRatio 时,短边会固定为 720。两个值都省略时,会以 3:2 比例的 1872x1248 输出。即便是同一个 Resolution,实际像素也会随比例而变,因此若需要精确尺寸,请用下文的 ExtInfo 直接指定。

4K / 5:4 组合会以 2688x2160 输出。

直接指定像素尺寸 ​

在 ExtInfo 中放入 size 时,会优先于 Resolution 与 AspectRatio 生效。取值为 宽x高 格式。

json
{
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\":\\\"1808x1024\\\"}\"}"
}
输入值实际输出
1808x10241808x1024
656x1024656x1024
656x1000656x992(向下取整到 16 的倍数)
auto按提示词自动决定
100x100256x256(按下限修正)

输出尺寸会按 16 的倍数与最小尺寸基准进行修正。auto 在同时指定 Resolution 时以该分辨率为基准决定比例,单独使用时则以提示词为基准决定。

参考图片 ​

在 FileInfos 中指定 Type 与 Url。图片文件请把 Type 设为 Url。

json
{
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<host>/reference.png"
    }
  ]
}
项目值
允许的字段Type(Url), Url / ReferenceType(可选)
参考张数最多 6 张
格式jpeg, png, webp

参考图片字段

FileInfos 指定 Type="Url" 与图片 Url。

运营参考 ​

项目值
1K 处理时间12 秒 为 21 秒
2K 处理时间21 秒 为 30 秒
4K 处理时间34 秒 为 46 秒

多图片请求按顺序处理。请在 DescribeTaskDetail 中确认 Status="FINISH" / ErrCode=0 与 Output.FileInfos 之后,再提交下一个请求。

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