跳到内容

Image2 ​

更新时间

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

Image2 是图片生成模型,支持文生图与多图参考生成,并提供蒙版局部编辑、透明背景、多张输出与自定义尺寸。对多语言文字渲染支持较好,适合海报与带字设计。

基本信息 ​

项目值
ModelNameOG
ModelVersionimage2_* / 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:21
image2.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选填ObjectResolution / 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 两种,档位共五档。

档位sunburstflare
lowimage2.5_sunburst_lowimage2.5_flare_low
mediumimage2.5_sunburst_mediumimage2.5_flare_medium
highimage2.5_sunburst_highimage2.5_flare_high
xhighimage2.5_sunburst_xhighimage2.5_flare_xhigh
maximage2.5_sunburst_maximage2.5_flare_max

2.0 系列直接使用 image2_low / image2_medium / image2_high。

质量档位 ​

档位越高,精度越高,生成时间也越长。

档位特点用途
low生成速度最快草稿、批量测试、提示词反复验证
medium速度与画质的平衡点日常制作、通用设计
high细节、质感与光源表现增强供评审的产出、需要细节表现的图片
xhigh精度高于 high最终评审、放大使用
max最高精度,擅长处理复杂文字与小字号最终交付物、印刷品、高精度产品图

各系列的生成时间

以上为在相同提示词与 1024x1024 条件下测得的值,会随网络状况与服务器负载而变化。

系列lowmediumhighxhighmax
sunburst30 秒30 秒53 秒92 秒169 秒
flare22 秒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 输出
1080P1920x1088
2K2560x1440
4K3840x2160

自定义分辨率生成 ​

在 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/"
  }
}

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