请输入
菜单

编辑图像(OpenAI)

上传原图并提供编辑指令,按模型能力生成修改后的图片。

请求

项目 说明
方法 POST
路径 /v1/images/edits
网关地址 https://ailink.nativex.com
认证 Authorization: Bearer sk-xxxx,替换为你的 API Key
请求格式 multipart/form-data

示例中的 MODEL_ID 请替换为「模型广场」中支持本接口的模型名称。模型、参数支持范围与可用权限以当前账户为准。

参数说明

参数 位置 类型 必填 说明
model Body string 是 支持图片编辑的模型
image Body file 是 需要编辑的图片;格式和大小由模型决定
prompt Body string 是 编辑指令
mask Body file 否 支持遮罩编辑的模型可上传蒙版,尺寸应与原图一致
n Body integer 否 输出图片数量,示例使用 1
size Body string 否 输出尺寸,以模型支持值为准
response_format Body string 否 url 或 b64_json;以模型支持为准
不同代际模型的图片要求不同,不要把某个旧模型的 PNG、方形或 4 MB 限制套用到所有模型。上传文件时不要手工设置 multipart boundary。

调用示例

curl -X POST 'https://ailink.nativex.com/v1/images/edits' \
  -H 'Authorization: Bearer sk-xxxx' \
  -F 'model=MODEL_ID' \
  -F 'image=@input.png' \
  -F 'prompt=将背景改为蓝色,保留主体' \
  -F 'n=1'

响应

以下为便于阅读的简化结构示例,标识、链接、文本及用量均为示意值。

{
  "created": 0,
  "data": [
    {
      "url": "https://example.com/generated.png"
    }
  ]
}
字段或结果 说明
data[] 生成图片的 URL 或 Base64 数据

错误处理

非成功响应时,先查看 HTTP 状态和错误正文。检查 API Key、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。

最近修改: 2026-10-28