EasyRouterEasyRouter
使用指南API 文档接入 Agent 工具
AI 模型接口图像(Images)OpenAI 格式

编辑图像

在给定原始图像和提示的情况下创建编辑或扩展图像。

注意: 此接口使用 multipart/form-data 格式上传图片文件,需通过 curl 或 SDK 调用,不支持在页面调试面板中直接发送。

curl -X POST "https://easyrouter.io/v1/images/edits" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F model="gpt-image-2" \
  -F image="@/path/to/image.png" \
  -F prompt="A cute baby sea otter wearing a beret."
POST/v1/images/edits

Authorization

BearerAuth

AuthorizationBearer <token>

使用 Bearer Token 认证。 格式: Authorization: Bearer sk-xxxxxx

In: header

Request Body

multipart/form-data

model*string

图像编辑模型的 ID。

image*file

要编辑的图像文件(PNG 格式,小于 4MB,方形)。如果未提供遮罩,图像必须具有透明度。

Formatbinary
prompt*string

所需图像的文本描述。最大长度为 1000 个字符。

mask?file

遮罩图像文件(PNG 格式,小于 4MB,与原图同尺寸)。完全透明区域指示 image 应编辑的位置。

Formatbinary
n?string

要生成的图像数。必须介于 1 和 10 之间。

size?string

gpt-image-2 支持 1024x10241536x10241024x1536autodall-e-2 支持 256x256512x5121024x1024

user?string

代表您的最终用户的唯一标识符。

Response Body

application/json

curl -X POST "https://easyrouter.io/v1/images/edits" \  -F model="gpt-image-2" \  -F image="string" \  -F prompt="A cute baby sea otter wearing a beret."
{}