Hy HOT
Endpoint: POST https://vod.intl.tencentcloudapi.comAction: CreateAigcImageTask
Hy Image 是腾讯混元的图片生成模型,支持文生图与参考图生成 / 编辑。3.5-preview 支持基于上一轮结果的多轮再编辑。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | Hunyuan |
| ModelVersion | 3.5-preview / 3.0 |
| 默认值 | ModelVersion=3.5-preview |
| 支持的模式 | 文本生成、参考图片生成、产物再编辑 |
| 护栏解除支持 | 不支持 |
Hy Image 不适用输入·输出护栏解除参数。
同时支持文本生成与基于参考图片的生成。
3.0 可输入参考图片 3 张,3.5-preview 可输入至 6 张。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 Hunyuan |
ModelVersion | 可选 | String | 3.5-preview / 3.0 |
Prompt | 必填 | String | 生成提示词。若有参考图片,则作为编辑指令生效 |
FileInfos.N | 可选 | Array | 参考图片。放入 Type 与 Url |
OutputConfig.Resolution | 可选 | String | 1K / 2K / 4K |
OutputConfig.AspectRatio | 可选 | String | 1:1 / 16:9 / 9:16 / 4:3 等 |
OutputConfig.PersonGeneration | 可选 | String | AllowAdult / Disallowed |
ExtInfo | 可选 | String | 直接指定像素尺寸。请参考下文条目 |
每个请求的输出图片
3.5-preview 每个请求生成 1 张 图片。多张请按顺序提交请求。
请求示例
这是文本生成。
{
"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 会被解释为编辑指令。
{
"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"
}响应示例
{
"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 的倍数。
| Resolution | 1:1 | 16:9 | 9:16 | 4:3 | 3:4 |
|---|---|---|---|---|---|
| 省略 | 720x720 | 1280x720 | 720x1280 | 960x720 | 720x960 |
1K | 1024x1024 | 1808x1024 | 1024x1808 | 1360x1024 | 1024x1360 |
2K | 2048x2048 | 2048x1152 | 1152x2048 | 1920x1440 | 1440x1920 |
4K | 4096x4096 | 3840x2160 | 2160x3840 | 3840x2880 | 2880x3840 |
省略 Resolution 而只放入 AspectRatio 时,短边会固定为 720。两个值都省略时,会以 3:2 比例的 1872x1248 输出。即便是同一个 Resolution,实际像素也会随比例而变,因此若需要精确尺寸,请用下文的 ExtInfo 直接指定。
4K / 5:4 组合会以 2688x2160 输出。
直接指定像素尺寸
在 ExtInfo 中放入 size 时,会优先于 Resolution 与 AspectRatio 生效。取值为 宽x高 格式。
{
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\":\\\"1808x1024\\\"}\"}"
}| 输入值 | 实际输出 |
|---|---|
1808x1024 | 1808x1024 |
656x1024 | 656x1024 |
656x1000 | 656x992(向下取整到 16 的倍数) |
auto | 按提示词自动决定 |
100x100 | 256x256(按下限修正) |
输出尺寸会按 16 的倍数与最小尺寸基准进行修正。auto 在同时指定 Resolution 时以该分辨率为基准决定比例,单独使用时则以提示词为基准决定。
参考图片
在 FileInfos 中指定 Type 与 Url。图片文件请把 Type 设为 Url。
{
"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 之后,再提交下一个请求。