Skip to content

POST /v1/images/edits

OpenAI 风格图片编辑接口。

请求

内容
方法POST
路径/v1/images/edits
鉴权API Key 或登录 JWT
Content-Typemultipart/form-data

Header 参数

参数必填说明
AuthorizationBearer sk-...Bearer <jwt>
x-api-key可替代 Authorization
Content-Typemultipart/form-data,由客户端带 boundary。

Query 参数

参数必填说明
key可替代 Header。

Form 参数

参数必填类型说明
modelstring平台图片编辑模型名。
imagefile/file[]输入图片文件。后端会转发所有 image 文件。
promptstring编辑提示词;后端敏感词和计费会读取。
maskfile遮罩图片。
ninteger输出数量。
sizestring输出尺寸。
response_formatstringurlb64_json
userstring透传给上游。

未列出的表单字段也会保留并转发。

返回值

OpenAI 图片编辑响应:

json
{
  "created": 1760000000,
  "data": [
    {
      "url": "https://example.com/image.png",
      "b64_json": ""
    }
  ],
  "usage": {}
}

基于 MIT 协议发布(社区版)