OpenAI

1. 概述

业界第一大语言模型。根据文字提示修改图片。

模型列表：

• gpt-image-2

2. 请求说明

• 请求方法:POST

• 请求地址:

  https://gateway.theturbo.ai/v1/images/edits

---

3. 请求参数

3.1 Header 参数

参数名称	类型	必填	说明	示例值
Content-Type	string	是	设置请求头类型，必须为 multipart/form-data	multipart/form-data; boundary=------------------------y0QNRDhXQUE3yHQi7DEbLz
Accept	string	是	设置响应类型，建议统一为 application/json	application/json
Authorization	string	是	身份验证所需的 API_KEY，格式 Bearer $YOUR_API_KEY	Bearer $YOUR_API_KEY

---

3.2 Body 参数 (application/json)

参数名称	类型	必填	说明	示例
model	string	是	要使用的模型 ID。详见概述列出的可用版本，如 gpt-image-2。	gpt-image-2
prompt	string	是	一段描述所需图像的文字gpt-image-2描述最大长度为 32000 字符。	A cute baby sea otter
image	file/file array	是	提交用于编辑的图像。对于gpt-image-2，每张图像应为小于 25MB 的 PNG、WEBP 或 JPG 文件。您最多可以通过数组提交 16 张图像。
mask	file	否	一个附加图像，其完全透明的区域（例如 alpha 为零的地方）表示图像应被编辑的位置。如果提供了多张图像，遮罩将应用于第一张图像。必须是有效的 PNG 文件，小于 4MB，且尺寸必须与图像相同。
n	number	否	生成图像的数量，必须在 1 到 10 之间。gpt-image-2仅支持 n=1。	1
size	string	否	生成图像的尺寸。gpt-image-2支持任意分辨率，以WIDTHxHEIGHT字符串形式指定，WIDTH和HEIGHT都必须能被 16 整除，且请求的宽高比必须介于1:3和3:1之间，最大支持3840x2160。	1024x1024
quality	string	否	生成图像的质量选项。gpt-image-2支持high、medium、low。	high

---

4. 请求示例

单图片

curl -X POST https://gateway.theturbo.ai/v1/images/edits \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F "model=gpt-image-2" \
	-F "image=@input.png" \
	-F 'prompt=A cute baby sea otter wearing a beret' \
	-F ... 其它参数

多图片

curl -X POST https://gateway.theturbo.ai/v1/images/edits \
	-H "Authorization: Bearer $YOUR_API_KEY" \
	-F "model=gpt-image-2" \
	-F "image[]=@input1.png" \
	-F "image[]=@input2.png" \
	-F 'prompt=A cute baby sea otter wearing a beret' \
	-F ... 其它参数

5. 响应示例

b64_json

{
	"created": 1589478378,
	"data": [{
			"b64_json": "..."
		},
		{
			"b64_json": "..."
		}
	],
	"usage": {
		"input_tokens": 0,
		"input_tokens_details": {
			"image_tokens": 0,
			"text_tokens": 0
		},
		"output_tokens": 0,
		"total_tokens": 0,
		"output_tokens_details": {
			"image_tokens": 0,
			"text_tokens": 0
		}
	}
}