图像 (Images) - 编辑图像 (原生 OpenAI 格式)

在给定原始图像和提示的情况下创建编辑或扩展图像。

接口地址: POST /v1/images/edits
请求格式 (Content-Type): multipart/form-data

认证与请求头 (Headers)

Authorization (必选): 使用 Bearer Token 认证。格式: Bearer <token>

请求参数 (Request Body - FormData)

参数名	类型	必选	说明
`image`	File (binary)	是	要编辑的图像。必须是有效的 PNG 文件，大小小于 4MB，并且是方形的。如果未提供遮罩(`mask`)，图像必须具有透明度，该透明区域将被用作遮罩。
`prompt`	String	是	所需图像的文本描述。最小长度1，最大长度为 32000 个字符。
`mask`	File (binary)	否	附加图像，其完全透明区域（例如，alpha 为零的区域）指示 `image` 应编辑的位置。必须是有效的 PNG 文件，大小小于 4MB，并且尺寸与原始 `image` 相同。
`model`	String	否	模型名称（如 `dall-e-2` 等）。
`n`	String/Integer	否	要生成的图像数量。必须介于 1 和 10 之间。
`size`	String	否	生成图像的大小。必须是 `256x256`、`512x512` 或 `1024x1024` 之一。
`response_format`	String	否	生成的图像返回的格式。必须是 `url` 或 `b64_json`。
`user`	String	否	代表您的最终用户的唯一标识符，可以帮助监控和检测滥用行为。

示例代码 (cURL)

curl -X POST "[https://www.ominiapi.com/v1/images/edits/](https://www.ominiapi.com/v1/images/edits/)" \
  -H "Authorization: Bearer <您的_API_KEY>" \
  -F image="@/path/to/image.png" \
  -F prompt="A cute baby sea otter wearing a beret." \
  -F n="1" \
  -F size="1024x1024"

响应体结构 (Response - 200 OK)

成功请求将返回 JSON 格式结果，具体包含的内容取决于 response_format 参数（返回图片 URL 列表或 Base64 字符串列表）。

{
  "created": 1589478378,
  "data": [
    {
      "url": "https://..."
    }
  ]
}

Gemini

Anthropic

OpenAI

编辑图片

图像 (Images) - 编辑图像 (原生 OpenAI 格式)

认证与请求头 (Headers)

请求参数 (Request Body - FormData)

示例代码 (cURL)

响应体结构 (Response - 200 OK)

​图像 (Images) - 编辑图像 (原生 OpenAI 格式)

​认证与请求头 (Headers)

​请求参数 (Request Body - FormData)

​示例代码 (cURL)

​响应体结构 (Response - 200 OK)

图像 (Images) - 编辑图像 (原生 OpenAI 格式)

认证与请求头 (Headers)

请求参数 (Request Body - FormData)

示例代码 (cURL)

响应体结构 (Response - 200 OK)