跳到内容

GPT-Image 2.6 ​

更新时间

← 返回 GPT-Image 概览,查看版本对比与选型。

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

GPT-Image 2.6 是 GPT-Image 系列在 VOD 上的最新一代,于 2026-11-06 上线,提供两个系列:

系列定位适用场景
sunburst偏编辑精度以编辑精度为优先的工作流:复杂构图、精细修改、细小文字
flare偏快速出图快速、高质量的日常图片生成:批量草稿、提示词迭代

基础调用方式与 2.5 一致 —— 只需把 ModelVersion 换成一个 2.6 的取值,请求结构不用动。

在此之上,2.6 是 GPT-Image 系列中唯一支持 GIF 动图与 SVG 矢量图输出 的系列(2026-11-06 起),通过 ExtInfo 开启。

本页是 GPT-Image 系列三篇接口文档之一,另见 GPT-Image 2.0 与 GPT-Image 2.5。

基本信息 ​

项目取值
ModelNameOG
ModelVersionimage2.6_sunburst_* / image2.6_flare_* —— * 是占位写法,不是可直接传的取值,10 个实际取值见 ModelVersion 枚举
结果查询DescribeTaskDetail
支持解除护栏不支持

ModelVersion 枚举 ​

两个系列各五档,共 10 个取值。

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

质量档位怎么选 ​

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

档位特点推荐用途
low生成最快、成本最低快速草稿、批量测试、提示词迭代
medium速度、成本与画质的平衡点大多数日常生产与通用设计
high细节、纹理、光影更极致审阅用成品、需要细致表现的图片
xhigh比 high 更高的精度最终审阅、放大使用
max最高精度,擅长复杂文本与小字体最终成品、印刷物料、高精度产品图

2.6 没有单独的实测耗时表

生成时间整体趋势与 2.5 一致:同档位下 flare 明显快于 sunburst。2.5 的实测数据可作为量级参考。

请求参数 ​

参数必填类型说明
SubAppId必填Integer子应用 ID
ModelName必填String固定值 OG
ModelVersion可选String模型版本,如 image2.6_sunburst_medium。省略则取引擎默认值 image2_medium(即 2.0 系列)
Prompt必填String生成提示词,最多 32,000 个字符
FileInfos.N可选Array参考图片(image-to-image),最多 16 张。ReferenceType=mask 时作为蒙版。传图方式见参考图片的传入方式
OutputConfig.StorageMode可选StringTemporary(临时存储,有效期 7 天)/ Permanent(永久存储,生成 FileId)
OutputConfig.Resolution可选String1K / 2K / 4K
OutputConfig.AspectRatio可选String1:1 / 3:2 / 2:3 / 3:4 / 4:3 / 16:9 / 9:16 / 21:9 / 9:21
OutputConfig.OutputImageCount可选Integer生成张数,OG 为 1~8
OutputConfig.OutputFormat可选Stringjpeg / png。省略时跟随模型默认值。GIF / SVG 不走这个字段,见 GIF 与 SVG 输出
OutputConfig.PersonGeneration可选StringAllowAdult(允许成人)/ Disallowed(禁止人物或人脸)
OutputConfig.InputComplianceCheck可选String输入内容合规检查:Enabled / Disabled
OutputConfig.OutputComplianceCheck可选String输出内容合规检查:Enabled / Disabled
OutputConfig.LogoAdd可选String是否添加图标水印:Enabled / Disabled
InputRegion可选String输入的区域信息:Mainland(中国大陆)/ Oversea(海外)/ OverseaUSWest(海外-美西)
ExtInfo可选String承载模型专用选项的 JSON 字符串,详见特殊设置与 GIF 与 SVG 输出
SessionContext可选String回调时原样返回的会话标识

请求示例 ​

json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_sunburst_medium",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "AspectRatio": "1:1",
    "OutputImageCount": 1
  },
  "SessionContext": "job-001"
}

响应示例 ​

json
{
  "AigcImageTask": {
    "Status": "FINISH",
    "ErrCode": 0,
    "Progress": 100,
    "Output": {
      "FileInfos": [
        {
          "FileUrl": "http://<host>.vod2.myqcloud.com/.../aigcImageGenFile.png",
          "ExpireTime": "2026-08-01T10:29:48Z",
          "MetaData": {
            "Width": 1024,
            "Height": 1024,
            "Container": "png"
          }
        }
      ]
    }
  }
}

特殊设置 ​

以下用法在 2.0 / 2.5 / 2.6 三个系列之间完全一致。2.6 独有的 GIF / SVG 输出单独放在后一节。

参考图片的传入方式 ​

FileInfos 中每一项用 Type 指定图片来源:

Type配套字段说明
FileFileId点播媒体文件 ID
UrlUrl可公开访问的图片 URL
Base64Base64图片的 Base64 字符串

Base64 的限制

  • 所有文件大小总和不能超过 7 MB,避免转成 Base64 后超出云 API 10 MB 的请求包上限;
  • 图片格式须为 jpeg / jpg / png / webp;
  • 不要带 data:image/jpeg;base64, 之类的前缀。

多图参考 ​

一次请求可放入多张参考图片,最多 16 张。用于图片编辑、风格迁移、多图融合(如换背景、组合元素)。

json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_sunburst_medium",
  "FileInfos": [
    { "Type": "Url", "Url": "https://<cos>/room.png" },
    { "Type": "Url", "Url": "https://<cos>/fabric.jpg" }
  ],
  "Prompt": "redesign this room with the material palette of the second image, keep the layout unchanged",
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  },
  "SessionContext": "job-001"
}

多张输出 (OutputImageCount) ​

用 OutputConfig.OutputImageCount 指定一次生成的图片数量。OG 为 1~8 张(各引擎上限不同,Kling 为 1~9 张)。

json
{
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "AspectRatio": "9:16",
    "OutputImageCount": 3
  }
}

自定义分辨率 (size) ​

用 ExtInfo 的 size 直接指定输出分辨率。

条件值
宽高各为 16 的倍数
最长边3840px 以下(即最大不超过 4K)
总像素数655,360 ~ 8,294,400
json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_flare_high",
  "Prompt": "a serene japanese garden, soft morning light",
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  },
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\": \\\"2000x1104\\\"}\"}",
  "SessionContext": "job-001"
}

常用预设有 1024x1024(方)、1536x1024(横)、1024x1536(竖)。也支持 2K(2560x1440)与 4K(3840x2160)输出,超过 2560px 为实验性支持。

auto 模式 ​

在 size 填入 auto,模型会根据输入决定分辨率。

json
{
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"size\\\": \\\"auto\\\"}\"}"
}

auto 模式下 AspectRatio 不要传 auto

size 为 auto 时,AspectRatio 仍需指定具体比例,不能也填 auto。

图片编辑蒙版 ​

在 FileInfos 中一并放入指定了 ReferenceType=mask 的图片,对要编辑的区域进行蒙版处理。蒙版图与原图各占一项。

json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_sunburst_medium",
  "FileInfos": [
    {
      "Type": "Url",
      "Url": "https://<cos>/room-mask.png",
      "ReferenceType": "mask"
    },
    {
      "Type": "Url",
      "Url": "https://<cos>/room.png"
    }
  ],
  "Prompt": "the same sunny indoor lounge with a pool, but with a flamingo standing in the pool",
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "AspectRatio": "9:16"
  },
  "SessionContext": "job-001"
}

透明背景 ​

在 ExtInfo 的 background 填入 transparent,可生成背景透明的图片。

json
"ExtInfo": "{\"AdditionalParameters\": \"{\\\"background\\\":\\\"transparent\\\"}\"}"

VOD 与 MPS 的传递位置不同

同一个 OG 引擎,透明背景选项的放置位置不同:VOD 放入 ExtInfo 内的 AdditionalParameters(JSON 字符串被双重编码),MPS 则直接指定在最顶层的 AdditionalParameters。

输出格式 (OutputFormat) ​

用 OutputConfig.OutputFormat 指定输出格式。省略时使用模型默认值。

json
{
  "OutputConfig": {
    "StorageMode": "Permanent",
    "Resolution": "1K",
    "OutputFormat": "png"
  }
}
值说明
jpegJPEG 输出
pngPNG 输出

若需要无损,或后处理中要处理 alpha 通道与细节灰阶,请指定 png;若用于传递、容量更重要,则 jpeg 更有利。透明背景需配合 png。

文本渲染 ​

支持中、英、日、韩及阿拉伯文等多语种文本渲染,max 档位对复杂文本与小字体的表现最好。

GIF 与 SVG 输出(仅 2.6) ​

2026-11-06 起,2.6 系列(image2.6_sunburst_* / image2.6_flare_* 全部 10 个取值)可以直接输出 GIF 动图与 SVG 矢量图。2.0 / 2.5 系列不支持。

两者都在 ExtInfo 的 AdditionalParameters 中用 output_format 开启,不是 OutputConfig.OutputFormat(后者仍只接受 jpeg / png)。

output_format输出配套参数计费
gifGIF 动图(多帧)frame_count / frame_duration_ms按输入图片张数 + 输出图片的百万 token 计费
svgSVG 矢量图svg.model / svg.reasoning.effort输入图片与输出图片费用 + SVG 转化费用

GIF 动图 ​

参数(AdditionalParameters 内)类型说明
output_formatString固定为 gif
frame_countInteger帧数,2 ~ 16,默认 9
frame_duration_msInteger每帧时长(毫秒),20 ~ 2000,默认 200,按 10 ms 取整
sizeString单帧尺寸,auto 或 宽x高(如 752x1024)。宽高均为 16 的倍数,最长边 ≤ 3840,长短边比 ≤ 3:1
json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_sunburst_low",
  "Prompt": "the same sunny indoor lounge with a pool, but with a flamingo standing in the pool",
  "ExtInfo": "{\"AdditionalParameters\": \"{\\\"output_format\\\": \\\"gif\\\",\\\"frame_count\\\":10,\\\"frame_duration_ms\\\":200}\"}",
  "OutputConfig": {
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

AdditionalParameters 解码后的内容:

json
{ "output_format": "gif", "frame_count": 10, "frame_duration_ms": 200 }

动图时长怎么算

总时长 ≈ frame_count × frame_duration_ms。上例为 10 × 200 ms = 2 秒一轮;默认值(9 帧 × 200 ms)约 1.8 秒。

帧数 × 单帧尺寸有总预算

GIF 在内部会先把所有帧拼成一张拼图(sheet)再生成,因此受 frame_count × 单帧尺寸的总预算限制。超限时报错形如 No supported sheet fits 10 GIF frames at size '752x1024' —— 这就是帧数与单帧尺寸的组合超限。帧数越多,size 应设得越小;具体预算上限官方文档未给出,超限时请先减帧数或缩小 size。

SVG 矢量图 ​

SVG 需要额外指定一个 OG 多模态模型作为「SVG 作者模型」(svg.model)参与生成,因此会产生单独的转化费用。

参数(AdditionalParameters 内)类型说明
output_formatString固定为 svg
svg.modelStringSVG 作者模型,示例值 og-5.6-sol。可选值见下方列表
svg.reasoning.effortString作者模型的推理预算,示例值 medium
json
{
  "SubAppId": 123456789,
  "ModelName": "OG",
  "ModelVersion": "image2.6_sunburst_low",
  "Prompt": "the same sunny indoor lounge with a pool, but with a flamingo standing in the pool",
  "ExtInfo": "{\"AdditionalParameters\":\"{\\\"output_format\\\": \\\"svg\\\",\\\"svg\\\":{\\\"model\\\":\\\"og-5.6-sol\\\",\\\"reasoning\\\":{\\\"effort\\\":\\\"medium\\\"}}}\"}",
  "OutputConfig": {
    "StorageMode": "Temporary"
  },
  "SessionContext": "job-001"
}

svg.model 支持以下 20 个取值:

og-4.1 / og-4o / og-5 / og-5-chat / og-5-mini / og-5-nano / og-5.1 / og-5.1-chat / og-5.2 / og-5.2-chat / og-5.3-chat / og-5.3-codex / og-5.4 / og-5.4-mini / og-5.4-nano / og-5.4-pro / og-5.5 / og-5.5-pro / og-5.6-luna / og-5.6-sol

AdditionalParameters 解码后的内容:

json
{
  "output_format": "svg",
  "svg": {
    "model": "og-5.6-sol",
    "reasoning": { "effort": "medium" }
  }
}

SVG 有额外的转化费用

SVG 除了输入图片与输出图片的费用外,还会收取 SVG 转化费用,按 svg.model 所指定 OG 多模态模型的输入 / 缓存输入 / 输出百万 token 单价计费。具体单价以《AIGC 价格指南(客户)》为准。

相关文档 ​

文档说明
GPT-Image 概览三个系列的选型对比与公共规格
GPT-Image 2.5双系列、xhigh / max 档位、各档位生成时间实测
GPT-Image 2.0基础系列,画质档位至 high
VOD 快速开始VOD API 的鉴权、任务提交与结果查询

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