图像编辑

POST

https://api.tokencube.net/v2/llm/images/edits

图像编辑API，基于现有图像+文本指令，对图像进行局部或整体修改，适用于图片的风格调整、内容添加/删除、局部修改等场景。

当前展示通用接口文档，各模型支持的参数存在差异。请在顶部切换模型，或直接点击下方模型标签，查看专属文档。

支持模型:

请求参数

请求头

参数名称	描述
Authorizationstring	鉴权令牌，格式为 Bearer ${AIGATEWAY_TOKEN}
Content-Typestring	可选值：multipart/form-data multipart/form-data; boundary=${boundary}，boundary由请求工具自动生成

Body参数

参数名称	描述
modelstring	默认值：Default model configured on the channel 编辑图像使用的模型名称
promptstring	图像编辑的核心提示词（如“添加水印”“调整为动漫风格”）
imagestring	可选值：Common formats such as PNG, JPG 待编辑的图片文件或图片URL，示例如：image=@body-lotion.png、image[]=@body-lotion.png、image=http://xxx/body-lotion.png
maskstring	可选的遮罩文件，仅一张
ninteger	默认值：1 可选值：>0 生成编辑后图像的数量（部分模型仅支持1张，会忽略该字段）
sizestring	可选值：Varies by model 编辑后图像的宽高像素（部分模型仅支持特定分辨率）
response_formatstring	可选值：urlb64_json 编辑后图像的返回格式（部分模型仅支持特定格式，会忽略该字段）

请求示例

curl -v 'https://${base_url}/v2/llm/images/edits' \
  -H "Authorization: Bearer ***" \
  -F "image=@test2.png" \
  -F "prompt=Add watermark: Technology to the image" \
  -F "size=1024x1024"

响应参数

Body参数

参数名称	描述
createdinteger	编辑后图像的创建时间戳（Unix时间格式）
dataarray	编辑后的图像数组，数组长度与请求参数n一致（部分模型固定为1）
urlstring	编辑后图像的URL地址，仅当response_format=url时返回（必填）
b64_jsonstring	编辑后图像内容的Base64编码，仅当response_format=b64_json时返回（必填）

响应示例

{
  "created": 1754372091,
  "data": [
    {
      "url": "https://wcs-upload.edgecloudapp.com/0217543720879312b09856"
    }
  ]
}

状态码

描述（message）	HTTP状态码
请求成功，返回编辑后的图像数据	200
访问被拒绝，拒绝原因见响应主体。可能原因：缺少Authorization请求头、token无效或过期等	401
访问被拒绝，拒绝原因见响应主体。可能原因：请求主体格式错误、缺少必填参数（如image、prompt）等	403
服务器内部错误，错误原因见响应主体	500

请求参数

请求示例

响应参数

响应示例

状态码

目录