跳到内容

Hy ​

更新时间

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

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

基本信息 ​

项目值
ModelNameHunyuan
ModelVersion3.5-preview / 3.0
是否支持关闭安全围栏不支持

Hy Image 不适用输入·输出安全围栏关闭参数。

支持文本生成与参考图编辑。

3.0 支持 3 张参考图,3.5-preview 最多支持 6 张。

请求参数 ​

参数必填类型说明
ModelName必填String固定值 Hunyuan
ModelVersion选填String3.5-preview / 3.0
Prompt必填String生成提示词。最多 1000 个字符。存在参考图时作为编辑指令生效
EnhancePrompt选填Boolean提示词自动优化。默认值 false
ImageInfos.N选填Array参考图数组。每项使用 ImageUrl 字段
ExtraParameters选填ObjectResolution / AspectRatio 等输出选项
AdditionalParameters选填String直接指定像素尺寸。{"size":"1808x1024"}
OutputImageCount选填Integer顶层字段。在 3.5-preview 中仅返回 1 张

MPS 输出配置

分辨率与宽高比在 ExtraParameters 中指定,输出张数在顶层 OutputImageCount 中指定。

请求示例 ​

json
{
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "a serene japanese garden, soft morning light",
  "ExtraParameters": {
    "Resolution": "2K",
    "AspectRatio": "16:9"
  },
  "Operator": "admin",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}
json
{
  "ModelName": "Hunyuan",
  "ModelVersion": "3.5-preview",
  "Prompt": "change the car color to matte black, keep the composition",
  "ImageInfos": [
    {
      "ImageUrl": "https://<host>/car.png"
    }
  ],
  "ExtraParameters": {
    "Resolution": "1K",
    "AspectRatio": "16:9"
  },
  "Operator": "wiki-example",
  "StoreCosParam": {
    "CosBucketName": "<bucket-appid>",
    "CosBucketRegion": "<bucket-region>",
    "CosBucketPath": "/aigc/"
  },
  "EnhancePrompt": false
}

响应示例 ​

json
{
  "Response": {
    "Status": "DONE",
    "Message": "ok",
    "ImageUrls": [
      "https://aigc-output-image-<id>.cos.<region>.myqcloud.com/<file>.png?q-sign-algorithm=sha1&..."
    ],
    "RequestId": "<request-id>"
  }
}

特殊配置 ​

输出分辨率 ​

下表为 ExtraParameters.Resolution 与 ExtraParameters.AspectRatio 各组合对应的实际输出像素。使用与 VOD 接口相同的映射关系。

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

省略 Resolution 且只传入 AspectRatio 时,短边固定为 720。两个值都省略时,按 3:2 宽高比输出为 1872x1248。

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

直接指定像素尺寸 ​

在 AdditionalParameters 中传入 size 时,其优先级高于 ExtraParameters 的分辨率与宽高比。取值格式为 宽x高,与 VOD 接口不同,JSON 只需转义一层。

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

参考图 ​

在 ImageInfos 中输入参考图的 ImageUrl。

json
{
  "ImageInfos": [
    {
      "ImageUrl": "https://<host>/reference.png"
    }
  ]
}
项目值
必填字段ImageUrl
参考图数量最多 6 张
格式jpeg, png, webp

参考图输入

在 ImageInfos 中指定 ImageUrl。可同时使用 ReferenceType。

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