AI图像物体擦除
POST
/aiapi/v1/erase修改时间: 6 个月前
通过蒙版擦除图片上多余的物体,并使之与背景进行融合 。
单次调用成功消耗10积分
rect坐标示意图
rect案例
- rectType为position时候,rect中所有坐标都是图片中的像素
- rectType为ratio的时候,rect中的值表示图片对应宽高的百分比,例如要生成一个宽高都只有图片50%并且居中的四边形区域,rect和rectType可以按照如下参数传:
{ "rectType": "ratio", "rect": { "left": 0.25, "top": 0.25, "right": 0.75, "bottom": 0.75 } }
请求参数
Body 参数application/json
image
string
图片
支持图片url或者base64格式图片,图片大小不可以超过4096x4096
mask
string
擦除遮罩图
图片以黑色作为底色,需要擦除部分为白色的蒙版图。
注意:蒙版比例需要与图片一致,否则会出现擦除区域不准确的问题。
支持base64格式图片或者图片url(需公网可访问)
maskPrompt
string
需要擦除的内容描述
支持中英文描述
示例值:
penceil,rule花瓶,树木
maskNegativePrompt
string
不需要擦除的内容
配合maskPrompt
使用,用于排除掉某个物体。
例如:maskPrompt为首饰
,可以通过maskNegativePrompt排除掉项链
rect
object
一个需要擦除区域的4边形
定义四边形的两个顶点,分别是左上角顶点和右下角顶点
left
number
左上角顶点x
top
number
左上角顶点y
right
number
右下角顶点x
bottom
number
右下角顶点y
rectType
string
四边形类型
枚举值:
positionratio
默认值:
ratio
syncInvoke
boolean
是否同步调用
同步调用任务完成后才回返回请求
默认值:
false
示例
{
"image": "string",
"mask": "string",
"maskPrompt": "penceil,rule",
"maskNegativePrompt": "string",
"rect": {
"left": 0,
"top": 0,
"right": 0,
"bottom": 0
},
"rectType": "ratio",
"syncInvoke": false
}
示例代码
返回响应
异步调用(200)
同步调用(200)
HTTP 状态码: 200
内容格式: JSONapplication/json
数据结构
data
object
必需
示例
{
"data": {
"balanace": 2378612,
"taskLimit": 200,
"sign": "9600bc006c8e46a8b541e536ed45a95e",
"used": 10
},
"code": 0,
"success": true
}
修改于 6 个月前