跳转到主要内容
POST
/
api
/
ai
/
image
/
edit
编辑图像
curl --request POST \
  --url https://aitoearn.cn/api/ai/image/edit \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "model": "<string>",
  "image": "<string>",
  "prompt": "<string>"
}
'
{
  "code": 0,
  "message": "请求成功",
  "data": {
    "created": 1,
    "list": [
      {
        "url": "string",
        "b64_json": "string",
        "revised_prompt": "string"
      }
    ],
    "usage": {
      "input_tokens": 1,
      "output_tokens": 1,
      "total_tokens": 1
    },
    "background": "string",
    "output_format": "string",
    "quality": "string",
    "size": "string"
  }
}

授权

​
X-Api-Key
string
header
必填

AiToEarn Open Platform API Key。

请求体

application/json
​
model
string
必填

图像编辑模型名称。先调用「图像编辑模型」接口（GET /api/ai/models/image/edit），传入其返回的 data[n].name；各模型支持的尺寸、最大输入图片数与价格以该接口返回为准。

​
image
必填

原始图片

​
prompt
string
必填

编辑描述

Required string length: 1 - 4000
​
mask
string

遮罩图片 URL，用于局部重绘（可选）。需为与 image 尺寸一致的 PNG 图片：完全透明（alpha 为 0）的区域表示需要按提示词重绘的部分，不透明区域保持原图不变。不传时对整张图片进行编辑。

​
n
integer

生成图片数量

必填范围: 1 <= x <= 1
​
size
string

图像尺寸。可选值随模型而不同，以「图像编辑模型」接口返回的 data[n].sizes 为准；不同尺寸的价格不同，见 data[n].pricing。

​
response_format
enum<string>

返回格式

可用选项:
url,
b64_json

响应

200 - application/json

请求已被服务处理。业务是否成功以响应体 code === 0 为准。

​
code
integer
必填

业务状态码。0 表示成功，非 0 表示业务错误。

​
message
string
必填

响应消息。

​
data
object
​
requestId
string

请求 ID。

​
timestamp
integer

错误响应时间戳，Unix 毫秒。