上传原图并提供编辑指令,按模型能力生成修改后的图片。
请求
| 项目 | 说明 |
|---|---|
| 方法 | 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、模型名称、账户额度及参数;遇到限流时降低并发并稍后重试。