Image2
Endpoint: POST https://mps.intl.tencentcloudapi.comAction: CreateAigcImageTask
Image2 是图片生成模型,支持文生图与多图参考生成,并提供蒙版局部编辑、透明背景、多张输出与自定义尺寸。对多语言文字渲染支持较好,适合海报与带字设计。
基本信息
| 项目 | 值 |
|---|---|
| ModelName | OG |
| ModelVersion | image2_* / image2.5_sunburst_* / image2.5_flare_* |
| 解除安全护栏 | 不支持 |
各版本支持的规格
| 版本 | 输出规格 | 输入及条件 |
|---|---|---|
| 通用 | 分辨率:1K / 2K / 4K;自定义尺寸适用以下像素限制宽高比: 1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 16:9 / 9:16 / 21:9 / 9:21image2.5:sunburst / flare 分别为 low, medium, high, xhigh, max | 参考图:最多 16 张 |
2.0 系列(image2_*)与 2.5 系列(image2.5_sunburst_* / image2.5_flare_*)通过同一个 ModelName 调用。支持质量档位选择、参考图、自定义分辨率与蒙版编辑。多语言文本渲染是其强项。
请求参数
| 参数 | 必填 | 类型 | 说明 |
|---|---|---|---|
ModelName | 必填 | String | 固定值 OG |
ModelVersion | 选填 | String | 模型版本。省略时使用引擎默认值 |
Prompt | 必填 | String | 生成提示词。最多 1000 个字符 |
EnhancePrompt | 选填 | Boolean | 提示词自动校正。默认值 false |
ImageInfos.N | 选填 | Array | 参考图数组。在 ImageUrl 中填入图片 URL,并通过 ReferenceType=mask 指定蒙版编辑 |
ExtraParameters | 选填 | Object | Resolution / AspectRatio 等输出选项 |
AdditionalParameters | 选填 | String | 承载模型专属选项的 JSON 字符串。seed 的传递格式参考附加配置。自定义尺寸 {"size":"2048x2048"}、自动 {"size":"auto"}、透明背景 {"background":"transparent"} |
请求示例
json
{
"ModelName": "OG",
"ModelVersion": "image2.5_sunburst_medium",
"Prompt": "a young woman in traditional hanbok standing by a moonlit lake",
"EnhancePrompt": true,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}参考图请求
json
{
"ModelName": "OG",
"ModelVersion": "image2.5_sunburst_medium",
"Prompt": "Change the background to a quiet garden; preserve the subject.",
"EnhancePrompt": true,
"ExtraParameters": {
"Resolution": "1080P",
"AspectRatio": "16:9"
},
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
},
"ImageInfos": [
{
"ImageUrl": "https://<host>/reference.jpg"
}
]
}响应示例
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>"
}
}特殊配置
模型版本
2.5 系列的 ModelVersion 采用 image2.5_{系列}_{档位} 格式。系列有 sunburst 和 flare 两种,档位共五档。
| 档位 | sunburst | flare |
|---|---|---|
low | image2.5_sunburst_low | image2.5_flare_low |
medium | image2.5_sunburst_medium | image2.5_flare_medium |
high | image2.5_sunburst_high | image2.5_flare_high |
xhigh | image2.5_sunburst_xhigh | image2.5_flare_xhigh |
max | image2.5_sunburst_max | image2.5_flare_max |
2.0 系列直接使用 image2_low / image2_medium / image2_high。
质量档位
档位越高,精度越高,生成时间也越长。
| 档位 | 特点 | 用途 |
|---|---|---|
low | 生成速度最快 | 草稿、批量测试、提示词反复验证 |
medium | 速度与画质的平衡点 | 日常制作、通用设计 |
high | 细节、质感与光源表现增强 | 供评审的产出、需要细节表现的图片 |
xhigh | 精度高于 high | 最终评审、放大使用 |
max | 最高精度,擅长处理复杂文字与小字号 | 最终交付物、印刷品、高精度产品图 |
各系列的生成时间
以上为在相同提示词与 1024x1024 条件下测得的值,会随网络状况与服务器负载而变化。
| 系列 | low | medium | high | xhigh | max |
|---|---|---|---|---|---|
sunburst | 30 秒 | 30 秒 | 53 秒 | 92 秒 | 169 秒 |
flare | 22 秒 | 22 秒 | 35 秒 | 41 秒 | 61 秒 |
分辨率规格
| 项目 | 限制 |
|---|---|
| 自定义分辨率 | 宽与高均为 16 的倍数 |
| 最长边 | 3840 px 以下 |
| 总像素 | 655,360 以上 8,294,400 以下 |
| 预设 | 1024x1024(正方形)、1536x1024(横向)、1024x1536(纵向) |
| 高分辨率 | 2K(2560x1440)、4K(3840x2160)。超过 2560px 仅提供有限支持 |
| 输出格式 | PNG, JPEG, WebP |
| 参考图 | 图片编辑、风格迁移、多图合成 |
| 背景透明度 | 支持。通过 AdditionalParameters 传入 {"background":"transparent"} |
在 ExtraParameters.Resolution 中指定预设后,分辨率将按宽高比确定。高度会校正为 16 的倍数。
| 预设 | AspectRatio=16:9 输出 |
|---|---|
1080P | 1920x1088 |
2K | 2560x1440 |
4K | 3840x2160 |
自定义分辨率生成
在 AdditionalParameters 中指定 size。取值必须为 16 的倍数,且总像素数在 655,360 以上 8,294,400 以下。也可通过 {"size":"auto"} 自动确定。
json
{
"ModelName": "OG",
"ModelVersion": "image2.5_flare_high",
"Prompt": "a serene japanese garden, soft morning light",
"EnhancePrompt": true,
"AdditionalParameters": "{\"size\":\"1536x1024\"}",
"Operator": "admin",
"StoreCosParam": {
"CosBucketName": "<bucket-appid>",
"CosBucketRegion": "<bucket-region>",
"CosBucketPath": "/aigc/"
}
}