编辑 OpenAI 图片

使用 multipart/form-data 上传原图并调用 gpt-image-2 编辑。model、prompt 和 image 为必填字段；当前已验证单张 PNG 输入、n=1、size=1024x1536、quality=high。蒙版、多图、n>1、流式返回和显式指定 response_format 尚未独立验证。

成功响应从 data[].b64_json 读取 Base64，并按 output_format 解码保存。本站实测返回 PNG 1024x1536，耗时 46.447s；usage.input_tokens_details.image_tokens 记录输入图片用量。实测耗时和费用只用于排查，不构成性能或价格承诺。

图片生成是同步长请求。客户端超时建议至少 300s，保存响应头 X-Oneapi-Request-Id。遇到客户端超时或 5xx 时先核对消费记录，不要自动重试；当前没有通过 Request ID 查询或找回图片的公开接口。Seedream 编辑使用 /v1/images/generations，请查看 Seedream 章节。

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

图片编辑结果。当前实测省略 response_format 后返回 data[].b64_json；按 output_format 解码。

Headers

Bodyapplication/json

示例

{
    "created": 1786400000,
    "background": "opaque",
    "data": [
        {
            "b64_json": "<BASE64_PNG_DATA>",
            "size": "1024x1536"
        }
    ],
    "output_format": "png",
    "quality": "high",
    "size": "1024x1536",
    "model": "gpt-image-2",
    "usage": {
        "input_tokens": 1637,
        "input_tokens_details": {
            "image_tokens": 1458,
            "text_tokens": 179
        },
        "output_tokens": 115,
        "output_tokens_details": {
            "image_tokens": 115,
            "text_tokens": 0
        },
        "total_tokens": 1752
    }
}

🟠400请求有误

🟠401没有权限

🟠429

🔴500服务器错误

🔴502网关错误

🔴503服务器故障

🔴504网关超时

🔴524

请求参数

请求示例代码

返回响应