GPT Image 2 图片生成与编辑 API 调用文档

本文档用于说明如何通过 HTTP API 调用图片生成和参考图编辑功能。调用前，请先向服务提供方申请 API Key

1. 接口基本信息

1.1 Base URL

http://api.tsbys.com

例如，图片生成接口的完整地址为：

http://api.tsbys.com/api/v1/images/generations

1.2 身份认证

所有接口均通过 Bearer Token 进行身份认证：

请将 YOUR_API_KEY 替换为实际的 API Key。不要把 API Key 公开在网页源码、公开仓库、截图或聊天记录中。

1.3 可用模型

输出规格	model 参数
2K	`gpt-image-2`
4K	`gpt-image-2-4k`

当前接口通过 model 字段区分 2K 和 4K。其他请求参数保持一致。

2. 文本生成图片

根据文本提示词生成一张图片。

2.1 请求地址

2.2 请求头

2.3 请求参数

参数	类型	必填	当前值/说明
`model`	string	是	2K 使用 `gpt-image-2`；4K 使用 `gpt-image-2-4k`
`prompt`	string	是	图片生成提示词；网站客户端最大限制为 6000 个字符
`n`	integer	是	当前固定为 `1`
`size`	string	是	当前固定为 `1024x1024`
`quality`	string	是	当前固定为 `low` 还可设置为：medium和high
`output_format`	string	是	当前固定为 `jpeg` ，还可设置为png

size和quality和background都支持auto

2.4 2K 请求示例

{
  "model": "gpt-image-2",
  "prompt": "一只戴着宇航员头盔的橘猫，站在月球表面，电影级灯光，细节清晰",
  "n": 1,
  "size": "1024x1024",
  "quality": "low",
  "output_format": "jpeg"
}

2.5 4K 请求示例

{
  "model": "gpt-image-2-4k",
  "prompt": "一只戴着宇航员头盔的橘猫，站在月球表面，电影级灯光，细节清晰",
  "n": 1,
  "size": "1024x1024",
  "quality": "high",
  "output_format": "jpeg"
}

注意：当前接入方式中，2K 与 4K 只通过 model 参数区分。选择 4K 时，size 字段仍保持 1024x1024，请不要自行修改其他参数。

2.6 cURL 示例

如需生成 4K 图片，只需把 model 改为 gpt-image-2-4k。

2.7 JavaScript 示例

2.8 Python 示例

3. 参考图编辑

上传一张或多张参考图，并根据提示词进行图片修改。

3.1 请求地址

3.2 请求头

使用 multipart/form-data 上传图片时，不要手动设置 Content-Type。浏览器或 HTTP 客户端会自动生成包含 boundary 的正确请求头。

3.3 FormData 参数

参数	类型	必填	当前值/说明
`model`	string	是	2K 使用 `gpt-image-2`；4K 使用 `gpt-image-2-4k`
`image[]`	file	是	参考图片；多张图片时重复提交同名字段 `image[]`
`prompt`	string	是	对参考图的修改要求
`n`	string/integer	是	当前固定为 `1`
`size`	string	是	当前固定为 `1024x1024`
`quality`	string	是	当前固定为 `low`
`output_format`	string	是	当前固定为 `jpeg`

3.4 单张参考图 cURL 示例

3.5 多张参考图 cURL 示例

3.6 JavaScript 示例

3.7 Python 示例

4. 返回结果

接口应返回 JSON。推荐使用以下两种格式之一。

4.1 返回图片 URL

{
  "data": [
    {
      "url": "https://example.com/generated/image.jpg"
    }
  ]
}

4.2 返回 Base64 图片

{
  "data": [
    {
      "b64_json": "图片的Base64内容"
    }
  ]
}

当前网站客户端还兼容以下图片字段：

data[0].b64_json

data[0].base64

data[0].image_base64

data[0].url

data[0].image_url

images[0] 中的上述字段

output[0] 中的上述字段

顶层 b64_json

顶层 url

5. 错误返回

请求失败时，接口应返回非 2xx HTTP 状态码和 JSON 错误信息，例如：

{
  "error": {
    "message": "Invalid API key"
  }
}

客户端兼容从以下字段读取错误信息：

error.message

error.error.message

message

msg

detail

error

常见问题：

情况	建议
`401` 或 `403`	检查 API Key 是否正确，以及是否带有 `Bearer` 前缀
`400`	检查必填参数、模型名称和文件字段名
`413`	上传图片过大，请压缩图片后重试
`429`	请求过于频繁或额度不足，请稍后重试
`500`/`502`/`503`	服务暂时异常，请稍后重试
`524` 或超时	图片生成时间超过网关限制，请稍后重试或联系服务方

6. 调用注意事项

model 必须使用文档中列出的准确模型名称。

2K 使用 gpt-image-2，4K 使用 gpt-image-2-4k。

当前约定中，除 model 外，2K 和 4K 的其他参数保持一致。

改图接口必须使用 multipart/form-data。

多张参考图必须重复提交 image[] 字段，不要改成 image[0]、image[1]。

使用 FormData 时不要手动设置 Content-Type，否则可能缺少 boundary。

图片生成可能耗时较长，建议客户端超时时间设置为 600 秒。

建议使用 PNG、JPEG 或 WebP 格式的参考图片。

请妥善保管 API Key，服务端程序调用时建议通过环境变量读取。

7. 快速对照

文本生图

POST /api/v1/images/generations
Content-Type: application/json
model = gpt-image-2 或 gpt-image-2-4k

参考图编辑

POST /api/v1/images/edits
Content-Type: multipart/form-data
model = gpt-image-2 或 gpt-image-2-4k
图片字段名 = image[]

如需 4K 输出，只需将请求中的：

"model": "gpt-image-2"

修改为：

"model": "gpt-image-2-4k"

gpt-image-2生图详解（可以发给agent）

GPT Image 2 图片生成与编辑 API 调用文档#

1. 接口基本信息#

1.1 Base URL#

1.2 身份认证#

1.3 可用模型#

2. 文本生成图片#

2.1 请求地址#

2.2 请求头#

2.3 请求参数#

2.4 2K 请求示例#

2.5 4K 请求示例#

2.6 cURL 示例#

2.7 JavaScript 示例#

2.8 Python 示例#

3. 参考图编辑#

3.1 请求地址#

3.2 请求头#

3.3 FormData 参数#

3.4 单张参考图 cURL 示例#

3.5 多张参考图 cURL 示例#

3.6 JavaScript 示例#

3.7 Python 示例#

4. 返回结果#

4.1 返回图片 URL#

4.2 返回 Base64 图片#

5. 错误返回#

6. 调用注意事项#

7. 快速对照#

文本生图#

参考图编辑#