OpenAI
图像编辑
DeerAPI 图像编辑接口文档：POST /v1/images/edits 调用说明，支持 mask、GPT 图像模型编辑与输出格式控制，qwen-image-edit 无需 n 且仅输出一张。
POST
/
v1
/
images
/
edits
图像编辑
curl --request POST \
--url https://api.deerapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form image='@example-file' \
--form 'prompt=Put on glasses' \
--form mask='@example-file'{
"created": 1776836647,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 981,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"input_tokens": 785,
"output_tokens": 196,
"input_tokens_details": {
"text_tokens": 17,
"image_tokens": 768,
"cached_tokens_details": {}
},
"claude_cache_creation_5_m_tokens": 0,
"claude_cache_creation_1_h_tokens": 0
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}使用这个接口可以上传原图，结合提示词和可选 mask 生成编辑结果。Documentation Index
Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt
Use this file to discover all available pages before exploring further.
适用场景
- 已有原图，希望按提示词改图
- 需要通过 mask 指定局部编辑区域
- 可以使用
multipart/form-data上传文件
建议起步请求
- 先传 1 张 PNG 或 JPG 原图
- 先不传 mask，确认基础改图流程
- GPT 图像编辑可使用
model: "gpt-image-2" - 从
data[0].b64_json读取结果 - 需要 JPEG 时，设置
output_format: "jpeg"
返回行为
- GPT 图像模型在该路由下返回 base64 图像数据
output_format控制b64_json中的图片编码格式response_format仅在模型支持 URL 输出时生效qwen-image-edit不需要n，且只输出 1 张
OpenAI Create image edit Qwen Image Edit API 不同模型的参数列表存在差异，当前页面仅展示通用请求形状。
Authorizations
Bearer token authentication. Use your DeerAPI key.
Body
multipart/form-data
要编辑的图像。必须是支持的图像文件或数组。
- GPT 图像模型：PNG 或 JPG，每张小于25MB。
- dall-e-3：一张正方形 PNG，小于4MB。
所需图像的文本描述。
- 最大长度：dall-e-2 为1000字符，GPT 图像模型支持较长文本。
Example:
"Put on glasses"
使用的模型：dall-e-3、gpt-image-2、gpt-image-1、gpt-image-1-mini 或 qwen-image-edit。默认为 gpt-image-2。
可选的 PNG 掩码图像。透明区域（alpha=0）表示需要编辑的区域。 必须与图像尺寸匹配，且小于4MB。适用于第一张图像。
生成的图像数量。必须在1到10之间。
仅适用于 GPT 图像模型。
Available options:
high, medium, low 响应容器格式。必须是 url 或 b64_json 之一。支持 URL 输出的模型会返回临时 URL；GPT 图像模型返回 data[].b64_json。如需指定图片编码格式，请使用 output_format。qwen-image-edit 不支持该参数。
Available options:
url, b64_json GPT 图像编辑结果的图片编码格式。返回仍位于 data[].b64_json 中；例如可设置为 jpeg。
Example:
"jpeg"
图像尺寸：
- GPT 图像模型：1024x1024、1536x1024、1024x1536、auto（默认）
- dall-e-3：256x256、512x512、1024x1024
⌘I
图像编辑
curl --request POST \
--url https://api.deerapi.com/v1/images/edits \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form image='@example-file' \
--form 'prompt=Put on glasses' \
--form mask='@example-file'{
"created": 1776836647,
"usage": {
"prompt_tokens": 0,
"completion_tokens": 0,
"total_tokens": 981,
"prompt_tokens_details": {
"cached_tokens_details": {}
},
"completion_tokens_details": {},
"input_tokens": 785,
"output_tokens": 196,
"input_tokens_details": {
"text_tokens": 17,
"image_tokens": 768,
"cached_tokens_details": {}
},
"claude_cache_creation_5_m_tokens": 0,
"claude_cache_creation_1_h_tokens": 0
},
"data": [
{
"b64_json": "<base64-image-data>"
}
]
}