跳转到主要内容
POST
GPT-Image-2.6 · 文生图

简介

GPT-Image-2.6 是 OpenAI 的图像模型系列,包含面向快速迭代的 Flare 和面向精细视觉任务的 Sunburst。通过本页的 POST /v1/images/generations 端点,可以将文本描述转化为图片,适用于海报设计、商品展示、品牌插画、图标和信息图等场景。 除了 PNG、JPEG、WebP 静态图片,两个模型还支持 GIF 动图和 SVG 矢量图输出,具体可用性取决于项目权限及渠道支持。GIF 适合表达循环动作;SVG 适合需要缩放、调整路径或修改颜色的图标与插画。 生成时可分别通过 quality 控制渲染质量、通过 complexity 调整出图前的规划量,并设置尺寸与背景。两项参数相互独立,建议从满足需求的设置开始,再根据文字、布局和细节效果调整。优先考虑响应速度时可选择 Flare,注重复杂构图和细节表现时可选择 Sunburst。

模型选择

两个模型共用本页的端点、参数和响应结构。示例默认使用 Flare;切换为 Sunburst 时只需替换请求中的 model,其他字段按实际需求设置。

认证

string
必填
Bearer $GRAVITEX_API_KEY
string
必填
application/json

请求参数

请求示例

示例从环境变量 GRAVITEX_API_KEY 读取平台令牌,请先在当前终端设置该变量。文件上传使用 curl 的 -F 自动生成 Content-Type 和 boundary,不要手动把 Content-Type 固定成 multipart/form-data。

基础生成

GIF 动图

SVG 矢量图

当前渠道生成 SVG 需要提供 svg.model,省略会返回 missing_required_parameter。gpt-6.1-sol 与 reasoning.effort: "low" 已于 2026-11-09 实测成功;其他编写模型需确认当前渠道是否支持。

指定 SVG 编写模型

示例使用 2026-11-09 本渠道实测成功的 SVG 编写模型 gpt-6.1-sol。其他渠道或项目请替换为其可用的编写模型 ID。

字段说明

不要把 svg.model 填成 gpt-image-2.6-flare 或 gpt-image-2.6-sunburst 来代替编写模型。支持的编写模型及 effort 取值取决于当前项目和所选模型,请先确认可用性。
返回 data[0].b64_json 后,Base64 解码并保存为 .svg。费用包括参考图的 usage 和 SVG 编写模型的 svg_usage;两部分使用各自的费率。 user 为兼容旧请求保留,已废弃;新请求使用 safety_identifier。非空 safety_identifier 优先,未提供、null 或空字符串时才回退 user。

流式输出

限制与注意事项

GIF 的 size 表示每帧尺寸,受帧数、n 和模型像素预算共同约束;优先使用 auto,超过预算时减少帧数或尺寸。 GIF 可用于本端点,需要相应预览权限。不可使用 mask、stream、partial_images 或自定义 output_compression。帧数、单帧尺寸和 n 共用请求像素预算,超限时减少这些值或使用 size=auto。 SVG 仅用于本生成端点,要求项目具备相应权限、n=1,不支持 stream、partial_images、output_compression、prompt_rewriter。当前渠道须提供 svg.model。 complexity 没有独立附加费,但可能影响延迟和输出结果。不要把低复杂度视为固定速度或固定单张价格保证。

响应示例

下面是非流式响应的结构示意,图片数据和 token 数仅为示例,并非实际生成结果。将 b64_json 解码为对应格式的文件;不要将 Base64 字符串直接保存为图片。
若设置 stream: true,响应为 SSE 事件流;按事件读取中间预览和最终图片,不能对整个响应直接调用 JSON 解析。

响应与计费

本页示例为非流式调用时,图片通过 b64_json 返回;不要传 response_format=url 期待图片链接。输入图片和输出图片均有 token 用量;相同 token 单价不代表相同单张费用,需结合实际 usage。 返回 data[].b64_json,按所选格式解码保存;usage 为 token 用量。SVG 另可能返回 svg_usage,包含编写模型的用量,按该模型费率另计。下表为 OpenAI 官方标准价,不是 GravitexAI 的报价;平台结算以控制台为准。

官方参考