GPT Image 图片生成 API 对接文档

认证方式: Authorization: Bearer {your_api_key}（网关令牌）
基础地址: https://aifast.site（你的 new-api 网关地址）
Content-Type: application/json 或 multipart/form-data（图片编辑接口）
最后更新: 2026-04-30

目录#

1. 模型列表#

2. 接口总览#

3. 图片生成#

接口#

POST /v1/images/generations

请求头#

请求体#

{
  "model": "gpt-image-2",
  "prompt": "一只可爱的橘猫坐在窗台上看夕阳",
  "n": 1,
  "size": "1024x1024",
  "quality": "auto",
  "response_format": "b64_json"
}

请求参数说明#

4. 图片编辑（参考图生图）#

接口#

POST /v1/images/edits

方式一：multipart/form-data（推荐，支持直接上传文件）#

方式二：application/json（传图片 URL）#

{
  "model": "gpt-image-2",
  "prompt": "将图片风格改为水彩画风格",
  "size": "1024x1024",
  "urls": [
    "https://example.com/reference1.jpg",
    "https://example.com/reference2.jpg"
  ]
}

注意：urls 字段为本网关扩展字段，置于 JSON body 顶层，包含参考图的公网可访问 URL 列表。

5. 尺寸说明#

标准尺寸（gpt-image-2 / gpt-image-2-vip 均支持）#

高分辨率尺寸（仅 gpt-image-2-vip 支持）#

标准 gpt-image-2 模型仅支持 1K 档位以内的尺寸；2K / 4K 档位须搭配 gpt-image-2-vip 使用。比例字符串（如 1:1、16:9）仍可直接填写，上游按默认分辨率处理。

6. quality 参数说明#

注意：quality 控制的是图片生成时的采样精细程度，与图片分辨率（2K/4K）无关。高分辨率输出请通过 size 参数传入像素值（如 2048x2048、4096x4096）实现。

7. 响应格式#

成功响应#

{
  "created": 1714444800,
  "data": [
    {
      "b64_json": "iVBORw0KGgo..."
    }
  ]
}

响应图片统一以 b64_json 形式返回，解码后即为 PNG 二进制数据。

8. 错误处理#

通用错误格式#

{
  "error": {
    "message": "错误描述",
    "type": "invalid_request_error",
    "code": "invalid_request"
  }
}

常见错误#

内容违规说明#

9. 计费说明#

10. 代码示例#

Python#

JavaScript / Node.js#

curl — 图片编辑（上传参考图）#