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

简介

GPT-Image-2 可通过 POST /v1/images/edits 基于参考图片和文本指令完成重绘、风格迁移及多图参考。请明确描述修改内容和需要保留的细节。该模型始终以高保真处理输入图片,应省略 input_fidelity;局部区域编辑使用 mask。

认证

string
必填
Bearer $GRAVITEX_API_KEY
string
必填
application/json / multipart/form-data

请求参数

images / mask

JSON 使用 images: [{"image_url": "https://..."}];也可传 base64 data URI。multipart 使用 image[] 上传文件。平台会将 JSON 编辑转为 multipart;不支持 OpenAI file_id 引用。此转换行为来自平台接入说明。 mask 可用于标识编辑区域,JSON 使用 image_url,multipart 上传文件。

请求示例

示例从环境变量 GRAVITEX_API_KEY 读取平台令牌,请先在当前终端设置该变量。文件上传使用 curl 的 -F 自动生成 Content-Type 和 boundary,不要手动把 Content-Type 固定成 multipart/form-data。
图片引用请使用可访问的 HTTPS URL 或 base64 data URI。multipart 示例先下载官方图片再上传。平台接入说明不支持 OpenAI file_id 引用。

JSON

multipart/form-data

user 为兼容旧请求保留,已废弃;新请求使用 safety_identifier。非空 safety_identifier 优先,未提供、null 或空字符串时才回退 user。

蒙版局部重绘

流式输出

限制与注意事项

auto 为默认值。显式尺寸使用 WxH,宽高均为 16 的倍数,宽高比在 1:3–3:1 之间。image-2 官方指南规定最长边不超过 3840px、总像素为 655,360–8,294,400。 官方 Images API 的 JSON 编辑支持 1–16 张输入图片,PNG / JPEG / WebP,每张小于 50MB。mask 为带 alpha 通道的 PNG,须与第一张参考图尺寸一致;透明区域指定编辑位置,蒙版用于引导生成,不保证像素级硬裁剪。请勿把平台未主动校验理解为上游无限制。 quality 使用 auto / low / medium / high,默认 auto。透明背景是 image-2 的预览能力;可用时使用 background=transparent,且输出格式选 PNG 或 WebP。仅介绍栅格生成与编辑,不将 2.6 的 complexity、GIF、SVG 或 2.5 的 markup 能力直接套用。

响应示例

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

响应与计费

本页示例为非流式调用时,图片通过 b64_json 返回;不要传 response_format=url 期待图片链接。输入图片和输出图片均有 token 用量;相同 token 单价不代表相同单张费用,需结合实际 usage。 返回 data[].b64_json 和 usage。图片数据须先 Base64 解码再保存。以下为 OpenAI 官方标准价,不是 GravitexAI 报价。 缓存价格是官方参考费率。官方指南说明,GPT Image 2 / 2.5 的缓存输入优惠仅适用于 Responses API 图像工具,不适用于直接调用本页 Images API(含 edits);平台实际结算以控制台为准。

官方参考