Skip to main content

gpt-image-2 接口说明

gpt-image-2 支持文生图和图片编辑。同一模型同时提供 AIHubMix 统一生成端点与 OpenAI 兼容端点: 新接入统一协议时,参阅 AIHubMix 图片生成接口。 本页示例使用 OpenAI 兼容端点,适合已有 OpenAI SDK 集成。
本页的生成、编辑、图片解码和非法参数流程已使用 gpt-image-2 实际验证。 模型能力可能调整,接入前请查询 模型 Schema 接口, 按 path 选择端点并读取该项的 request.schema,不要依赖 endpoints 数组位置。

准备工作

安装或升级 OpenAI Python SDK,并通过环境变量提供 API Key:
客户端配置:

生成图片

下面的示例生成一张低质量、1024x1024 的 PNG 图片,并将返回的 Base64 数据保存到 当前目录。
等价的 HTTP 请求为:

编辑图片

编辑接口接收 multipart/form-data。将待编辑图片放在当前目录并命名为 input.png
等价的 HTTP 请求为:

已确认参数

不要将其他 GPT Image 版本的参数直接套用到 gpt-image-2。字段、枚举和取值范围 以模型对应端点的 request.schema 为准。

返回示例

兼容生成与编辑接口均返回 OpenAI 图片响应。data[].b64_json 是图片的 Base64 内容, usage 给出本次请求的输入和输出 Token 用量。

错误响应

参数不符合模型支持范围时,接口返回结构化 4xx 错误。例如传入不支持的 quality: "ultra" 会返回 HTTP 400
收到错误后应先检查 error.paramerror.code,再对照当前模型对应路径的 request.schema 修正请求。