文档

Edits格式

更新时间:2026-11-11

请求方法与路径

POST
/v1/images/edits

OpenAI Images 原生格式,根据提示词编辑或扩展输入图片。请求体使用 multipart/form-data;也支持 application/json,此时图片以 URL 或 Base64 传入。

身份验证

详见调用指南 - 鉴权。

请求头参数

详见调用指南 - 公共请求头。

请求体

multipart/form-data
  1. body
model*string

模型 ID,如 gpt-image-1。

image*array<>

待编辑的图片文件,可传多张。

prompt*string

编辑要求的提示词。

mask?file

遮罩图片,透明区域为待编辑区域。

格式binary
n?integer

生成图片的数量。

范围1 <= value
默认值1
size?string

图片尺寸,如 1024x1024。

quality?string

图片质量,如 low、medium、high、auto。

response_format?string

返回格式,url 或 b64_json。部分模型固定返回 b64_json。

可选值"url""b64_json"
output_format?string

输出图片格式,如 png、jpeg、webp。

stream?boolean

是否流式响应。

响应体

成功创建响应

application/json
  1. response
created?integer

创建时间,Unix 时间戳(秒)。

data?array<>

生成的图片列表。

usage?

Token 用量统计。

请求示例
curl -X POST 'https://api.cysuo.com/v1/images/edits' \  -F 'model=string' \  -F 'image=[  "string"]' \  -F 'prompt=string'
响应示例200
{  "created": 0,  "data": [    {      "url": "string",      "b64_json": "string",      "revised_prompt": "string"    }  ],  "usage": {    "input_tokens": 0,    "input_tokens_details": {      "text_tokens": 0,      "image_tokens": 0    },    "output_tokens": 0,    "total_tokens": 0  }}