POST/v1/images/edits

图像编辑

平台接口会校验上传文件类型、大小与非文件字段，并统一返回 OpenAI 风格图片结果。

基础信息

鉴权	Authorization: Bearer sk-...
请求类型	multipart/form-data
响应类型	application/json

请求参数

FormData

字段

类型

必填

位置

说明

model

string

是

formData

图像编辑模型。

示例："gpt-image-1"

image

file

是

formData

待编辑的源图片。

mask

file

否

formData

可选遮罩文件。

prompt

string

是

formData

编辑指令。

示例："把画面改成更现代的产品首页风格"

size

string

否

formData

输出尺寸。

示例："1024x1024"

quality

string

否

formData

质量配置。

示例："high"

response_format

string

否

formData

返回格式。

示例："url"

响应示例

json

{
  "created": 1744512000,
  "data": [
    {
      "url": "https://cdn.example.com/generated/portal-home-edit.png"
    }
  ]
}

错误码

HTTP	code	说明
400	`invalid_request_error`	请求体结构不合法、缺少必填参数，或 JSON 无法解析。
401	`invalid_auth_header`	缺少或传错鉴权头，网关无法识别当前调用身份。
403	`model_not_allowed`	当前 API Key 没有访问该模型的权限。
402	`insufficient_balance`	余额不足，平台在调用前预检时已拒绝请求。
503	`model_not_available`	当前模型没有可用路由或上游渠道不可用。

在线调试

Playground · 浏览器直连网关

图像编辑

上传图片与可选遮罩进行编辑，采用 multipart/form-data。

Base URL Token / API Key

该接口为 multipart 文件上传场景。第一版 Playground 先提供完整请求样例；真实文件上传建议使用 cURL、Python 或业务系统调用。

提示：请在浏览器中手动选择本地图片文件，接口会使用 multipart/form-data 上传。

json

尚未发起请求。

bash

curl --location --request POST 'https://api.harnmodel.com/v1/images/edits' \
  --header 'Authorization: Bearer sk-xxx'

多语言示例

bash

curl --location --request POST 'https://api.harnmodel.com/v1/images/edits' \
  --header 'Authorization: Bearer sk-xxx'