跳转到主要内容
POST
/
v1
/
images
/
edits
编辑图像
curl --request POST \
  --url https://api.getinfinityblue.com/v1/images/edits \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "<string>",
  "prompt": "<string>",
  "image": "<string>",
  "images": [
    "<string>"
  ],
  "n": 1,
  "size": "<string>",
  "response_format": "b64_json",
  "output_compression": 50,
  "mask": "<string>",
  "input_image_mask": "<string>",
  "input_fidelity": "<string>",
  "user": "<string>"
}
'
{
  "created": 123,
  "data": [
    {
      "b64_json": "<string>",
      "url": "<string>"
    }
  ],
  "usage": {
    "total_tokens": 123,
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123
    }
  }
}

​
多参考图

通过 images 字段可传入 1–16 张额外参考图（URL、base64 或 File ID）， 配合主图 image 实现多图参考生成。

​
请求格式

支持两种请求格式：
  • multipart/form-data：以文件方式上传图像
  • application/json：以 base64 data URL（如 data:image/jpeg;base64,...）传入图像

​
遮罩说明

  • mask 和 input_image_mask 参数会被接受但当前不生效， 编辑始终作用于整图。如需局部编辑，建议在客户端自行合成。

​
输出尺寸

建议显式传入 size 参数以获得可控的输出尺寸。 不传 size 时，输出尺寸可能受输入图像影响而不稳定。

​
gpt-image-2 特有参数

参数说明
images（多参考图）支持 1–16 张参考图
input_fidelity自动高保真，API 忽略手动设置

授权

​
Authorization
string
header
必填

使用 Bearer Token 认证，格式：Authorization: Bearer sk-xxxxxx。 在 控制台 获取 API Key。

请求体

图像编辑请求体（JSON 格式）。图片以 base64 data URL（如 data:image/jpeg;base64,...） 或图片 URL 传入。

​
model
string
必填

使用的图像模型，传入 gpt-image-2。 快照版本（如 gpt-image-2-2026-04-21）暂不可用。

示例:

"gpt-image-2"

​
prompt
string
必填

所需图像编辑的文本描述，最大长度为 1000 个字符。

示例:

"把主图中的笔头替换成参考图中的圆头软质刷头，其余不变"

​
image
string
必填

主图像，支持 base64 data URL（如 data:image/jpeg;base64,...）或图片 URL。

​
images
string[]

额外参考图像列表（1–16 张），支持 base64 data URL 或图片 URL。 配合主图 image 实现多图参考编辑。

​
n
integer
默认值:1

本站暂不支持 n 参数，默认 n=1，每次请求输出 1 张图片。 如需多张图片，请循环调用接口。

必填范围: x >= 1
​
size
string

输出图像的尺寸。参数规则与生成接口一致，默认为 auto。 建议显式传入以获得可控的输出尺寸。

示例:

"1024x1024"

"1536x1024"

​
response_format
enum<string>
默认值:b64_json

返回图像的格式。默认为 b64_json，返回 Base64 编码的图像数据； 设为 url 时返回图像的临时访问 URL。

可用选项:
b64_json,
url
​
output_format
enum<string>

输出图像的格式。默认为 png，可选 png、jpeg、webp。

可用选项:
png,
jpeg,
webp
​
output_compression
integer

输出图像的压缩质量（0–100），仅在 output_format 为 jpeg 或 webp 时生效。

必填范围: 0 <= x <= 100
​
background
enum<string>

生成图像的背景设置。默认为 auto，可选 opaque（不透明）或 auto。 gpt-image-2 不支持 transparent（透明背景），传入该值会返回 400 错误。

可用选项:
opaque,
auto
​
quality
enum<string>

本站暂不支持 quality 分档，统一使用 auto 级别输出。 参数会被接受但各级别间无实际差异。

可用选项:
low,
medium,
high,
auto
​
mask
string

遮罩图像，base64 data URL 格式。 本站当前不支持遮罩编辑，参数会被接受但不生效，编辑始终作用于整图。

​
input_image_mask
string

gpt-image-2 专用遮罩字段，base64 data URL 格式。 本站当前不支持遮罩编辑，参数会被接受但不生效，编辑始终作用于整图。

​
input_fidelity
string

输入保真度设置。对于 gpt-image-2，强制高保真， API 会自动忽略此参数的手动设置。

​
user
string

代表终端用户的唯一标识符，可用于监控和滥用检测。

响应

成功生成编辑图像

图像生成响应体。

​
created
integer

创建时间的 Unix 时间戳（秒）。

示例:

1713833628

​
data
object[]

生成的图像列表。

​
usage
object

本次请求的 token 用量统计。