图像处理

POST /images/edits

对现有图片进行编辑处理，支持背景替换、图像放大、风格转换、局部修改、物体移除等。

接口信息

项目	说明
接口地址	POST https://api.seeany.com/v1/images/edits
Content-Type	multipart/form-data
认证方式	Bearer Token
超时时间	90 秒

请求参数

参数	类型	必填	说明
image	file	✅	原始图片
prompt	string	✅	编辑指令描述
mask	file	❌	遮罩图（白色区域为编辑区域，仅局部编辑需要）
model	string	❌	使用模型，默认 nano-banana
size	string	❌	输出尺寸，默认与原图一致

支持的操作

操作	prompt 示例	是否需要 mask
背景替换	"将背景替换为海边沙滩日落场景"	❌
风格转换	"转换为水彩画风格"	❌
图像放大	"4x 放大并增强细节"	❌
局部修改	"将衣服颜色改为红色"	✅
物体移除	"移除遮罩区域的物体并智能填补"	✅
添加元素	"在画面右侧添加一只蝴蝶"	❌

请求示例

Python

from seeany import SeeAny

client = SeeAny(api_key="sk-xxxxx")

# 背景替换（无需 mask）
result = client.images.edits(
    image=open("./product.jpg", "rb"),
    prompt="将背景替换为高级大理石台面，柔和studio灯光",
    model="nano-banana-pro"
)

# 局部修改（需要 mask）
result = client.images.edits(
    image=open("./product.jpg", "rb"),
    mask=open("./mask.png", "rb"),
    prompt="将衣服颜色改为红色",
    model="nano-banana-pro"
)

print(f"编辑结果: {result.data[0].url}")

cURL

# 背景替换
curl -X POST https://api.seeany.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxx" \
  -F "image=@./product.jpg" \
  -F "prompt=将背景替换为高级大理石台面，柔和studio灯光" \
  -F "model=nano-banana-pro"

# 局部修改（带 mask）
curl -X POST https://api.seeany.com/v1/images/edits \
  -H "Authorization: Bearer sk-xxxxx" \
  -F "image=@./product.jpg" \
  -F "mask=@./mask.png" \
  -F "prompt=将衣服颜色改为红色" \
  -F "model=nano-banana-pro"

响应示例

{
  "id": "edit_20260603_001",
  "object": "image",
  "status": "completed",
  "data": [
    {
      "url": "https://cdn.seeany.com/edit/edit_001/result.png",
      "revised_prompt": "Product on luxury marble countertop..."
    }
  ],
  "usage": { "cost": 0.18, "cost_unit": "CNY" }
}

Mask 遮罩说明

• 遮罩图尺寸需与原图一致
• 白色区域：需要编辑的区域
• 黑色区域：保持不变的区域
• 推荐使用 PNG 格式，边缘适当羽化

提示

• 编辑操作默认使用 nano-banana 模型，性价比高
• 如需更高编辑质量，可指定 model=nano-banana-pro
• 背景替换效果通常优于局部修改