Skip to main content
POST
/
v1
/
images
/
edits
图像编辑(gpt-image-1)
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'
{
  "data": [
    {
      "b64_json": "<string>"
    }
  ],
  "created": 123,
  "usage": {
    "prompt_tokens": 123,
    "completion_tokens": 123,
    "total_tokens": 123,
    "prompt_tokens_details": {
      "cached_tokens_details": {}
    },
    "completion_tokens_details": {},
    "input_tokens": 123,
    "output_tokens": 123,
    "input_tokens_details": {
      "text_tokens": 123,
      "image_tokens": 123,
      "cached_tokens_details": {}
    }
  }
}
由于不同模型支持的参数列表差异较大, 对于不同的模型, 我们建议您参考相应的官方文档:
OpenAI Create image edit Qwen Image Edit API 对于不同的模型, 我们建议您参考相应的官方文档, 不同模型, 当前的参数列表仅供参考参考
注意 “qwen-image-edit” 模型时不需要传参数 “n”,仅能输出一张

Authorizations

Authorization
string
header
required

Bearer token authentication. Use your DeerAPI key.

Body

multipart/form-data
image
file
required

要编辑的图像。必须是支持的图像文件或数组。

  • gpt-image-1: PNG或 JPG,每张小于25MB。
  • dall-e-3: 一张正方形 PNG,小于4MB。
prompt
string
required

所需图像的文本描述。

  • 最大长度:dall-e-2 为1000字符,gpt-image-1 为32000字符。
Example:

"Put on glasses"

model
string

使用的模型:dall-e-3 或 gpt-image-1,gpt-image-1-mini,qwen-image-edit 默认为 gpt-image-1

Example:

"gpt-image-1"

mask
file

可选的 PNG 掩码图像。透明区域(alpha=0)表示需要编辑的区域。 必须与图像尺寸匹配,且小于4MB。适用于第一张图像。

n
string
default:1

生成的图像数量。必须在1到10之间。

quality
enum<string>
default:auto

仅适用于 gpt-image-1。

Available options:
high,
medium,
low
response_format
enum<string>
  • 生成图像返回的格式。必须是 urlb64_json 之一。URL 在图像生成后仅在 60 分钟内有效。该参数仅支持 dall-e-2,因为 gpt-image-1 始终会返回经过 Base64 编码的图像。
  • qwen-image-edit 模型 不支持
Available options:
url,
b64_json
size
string

图像尺寸:

  • gpt-image-1: 1024x1024、1536x1024、1024x1536、auto(默认)
  • dall-e-3: 256x256、512x512、1024x1024

Response

200 - application/json

成功

data
object[]
required

包含响应数据对象的列表。

created
integer
required

请求创建的Unix时间戳 (秒)。

usage
object
required

Token使用情况统计。