Edits格式
更新时间:2026-11-11
POST
OpenAI Images 原生格式,根据提示词编辑或扩展输入图片。请求体使用 multipart/form-data;也支持 application/json,此时图片以 URL 或 Base64 传入。
详见调用指南 - 鉴权。
详见调用指南 - 公共请求头。
multipart/form-data- body
model*string模型 ID,如 gpt-image-1。
image*array<>待编辑的图片文件,可传多张。
prompt*string编辑要求的提示词。
mask?file遮罩图片,透明区域为待编辑区域。
格式
binaryn?integer生成图片的数量。
范围
1 <= value默认值
1size?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- 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 }}