Edits 通用 (图像编辑)

OpenAPI Specification

接口：POST /v1/images/edits（完整地址 https://api.allyang.cn/v1/images/edits）

鉴权：请求头 Authorization 传令牌，取值形如 Bearer {{YOUR_API_KEY}}（该字段非必填）。

请求体（multipart/form-data）

按原文档的请求体定义，image、prompt、model 三项为必传；文档参数表中列出的其余字段均可省略，一并记录如下。

• image：binary，必传；待编辑图片，可一次传多张。
• prompt：string，必传；描述期望的编辑效果。
• model：string，必传；可用 gpt-image-1、flux-kontext-pro、flux-kontext-max。
• mask：file，可选；PNG 遮罩，alpha 为 0 的透明区域即为待重绘部分，要求与图片同尺寸且小于 4MB，只对第一张图起作用。
• n：integer，可选；出图张数，可填 1 至 10，不传时按 1 处理。
• quality：string，可选；仅 gpt-image-1 适用，可填 high、medium、low，不传时按 auto 处理。
• response_format：string，可选；url 与 b64_json 二选一；仅 dall-e-2 支持 url，该地址 60 分钟内有效。
• size：string，可选；gpt-image-1 可填 1024x1024、1536x1024、1024x1536、auto（不传时的取值），dall-e-2 可填 256x256、512x512、1024x1024。

格式与长度：gpt-image-1 接受 PNG、WEBP、JPG，单张小于 25MB；dall-e-2 接受 1 张正方形 PNG，小于 4MB。prompt 的字符上限为 dall-e-2 1000、gpt-image-1 32000。

说明：原文档在参数说明文字里以 Default 与 Options 标注各字段的默认值与可选值（例如 response_format 的 Options 为 url 或 b64_json，且仅 dall-e-2 支持 url）。

响应

• 200：返回成功；示例返回里含 created（integer）、data[] 下的 b64_json，以及 usage（total_tokens、input_tokens、output_tokens，还有 input_tokens_details 下的 text_tokens 与 image_tokens）。

使用提示：本平台 Base URL 为 https://api.allyang.cn，OpenAI 兼容接口路径以 /v1 开头；示例里的 {{YOUR_API_KEY}} 请替换为控制台创建的令牌。