---
title: "OpenAI Images Edit 兼容入口"
method: POST
path: "/v1/images/edits"
tags: ["Gateway"]
---

# OpenAI Images Edit 兼容入口

`POST /v1/images/edits`

API Key 鉴权后转发到路由后的上游渠道。请求体支持 multipart/form-data 与 application/json（图片以 base64 或 data URL 传入）。

## Request body

- object
  - `image` union — 原始图片，base64 字符串或 data URL（data:image/png;base64,...），解码后最大 4MB；兼容单元素数组形态，不支持 http(s) URL。可省略：部分渠道（如 Gemini）无图时按纯 prompt 图片生成处理。
    - string
    - string[]
  - `mask` string — 可选遮罩图片，base64 字符串或 data URL，解码后最大 4MB。
  - `model` string — 模型名称，默认 dall-e-2。
  - `n` integer — 生成数量。
  - `prompt` string — 编辑提示词。
  - `quality` string — 输出质量。
  - `response_format` string — 返回格式。
  - `size` string — 输出图片尺寸。
  - `user` string — 终端用户标识。

## Response `200`

OK

## Other responses

- `400` — 请求体非法、缺少图片或缺少 prompt。
- `401` — API Key 无效或缺失。

---

[API](https://skmtc.dev/apiqik/apis/apiqik-api.md) · [All operations](https://skmtc.dev/apiqik/apis/apiqik-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apiqik/apiqik-api/revisions/e06b96127408/schema)