编辑图片

请求格式、响应与能力边界。

200

{
  "created": 1700000000,
  "data": [
    {
      "url": "https://cdn.example.com/image.png"
    }
  ]
}

POST /v1/images/edits

推荐从 multipart 文件上传开始：model、prompt、image，可选 mask。SDK/cURL 自动生成 boundary；支持多图时可使用渠道要求的重复 image[]。

JSON 请求表描述 images[].image_url 形式，仅适用于支持该形式的渠道；其他插件的字段可能不同。蒙版、参考图数量、格式和大小需按模型确认。项目通用 Files API 未实现，不提供统一 file_id 上传流程。

完整接入指南与可执行示例

Read in English

授权

Authorization · string · header · 必填

模型调用 API Key，不是控制台登录凭据 / Model API key, not console login credentials

请求体

multipart/form-dataapplication/json

model · string · 必填

当前密钥可用且支持此接口的模型 ID / Model ID available to the key and supporting this endpoint

示例:

"YOUR_MODEL_ID"

prompt · string · 必填

任务描述；遵循模型的长度和内容要求 / Task description; follow model length and content requirements

image · file · 必填

输入图片文件；重复 image[] 的支持取决于渠道 / Input image file; repeated image[] support depends on the channel

n · integer

请求图片数，模型通常有更小限制；建议从 1 开始 / Requested image count; models usually impose a smaller limit; start with 1

必填范围: 1 <= x <= 128

size · string

模型支持的尺寸，使用 x 而不是 × / Model-supported size; use x rather than ×

quality · string

质量档位，由模型决定 / Quality setting determined by the model

response_format · string

url 或 b64_json，仅在模型支持时指定；有些模型固定返回 Base64 / url or b64_json when supported; some models always return Base64

output_format · string

输出编码，例如 png、jpeg、webp；需模型支持 / Output encoding such as png, jpeg, webp; requires model support

background · string

背景选项；透明背景需模型和编码支持 / Background option; transparency requires model and format support

mask · file

可选蒙版；格式、尺寸与透明区域语义由模型决定 / Optional mask; format, dimensions, and transparent-area semantics depend on the model

响应

200

application/json

图片结果 / Image result

data · object[] · 必填

检查每项的 url 或 b64_json，不能仅凭 HTTP 200 判断有图片 / Check url or b64_json in each item; HTTP 200 alone does not guarantee an image

Show child attributes

created · integer

Unix 秒 / Unix seconds