自动检测并擦除商品图中的水印、Logo、促销贴纸、价格标签和多余文字,无需人工框选。
0.8积分/次基础说明
自动检测并擦除商品图中的水印、Logo、促销贴纸、价格标签和多余文字,无需人工框选。
提交任务
提交牛皮癣擦除任务。系统会自动检测并清理商品图中的水印、Logo、促销贴纸、价格标签和多余文字。
POST/api/third-party/imageElementRemoval/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证,用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image_url | string | 是 | 待清理图片的公网 HTTP/HTTPS URL;建议不超过 10 MB,宽 128-2560 px,高 128-1440 px,支持 png、jpg、jpeg、webp。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/imageElementRemoval/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://your-cdn.com/product-with-elements.jpg"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| code | number | - | 业务状态码,200 表示请求成功。 |
| message | string | - | 本次请求的结果说明。 |
| data.taskId | string | - | 任务 ID。提交成功后请保存,用于查询生成结果。 |
| data.cost | number | - | 本次提交预扣积分。 |
| data.status | string | - | 任务初始状态,通常为 pending 或 processing。 |
| timestamp | string | - | 响应时间,ISO 8601 格式。 |
响应示例
json
{
"code": 200,
"message": "牛皮癣擦除任务已提交",
"data": {
"taskId": "task_xxxxxxxx",
"status": "pending",
"image_url": "https://your-cdn.com/product-with-elements.jpg",
"cost": 0.8
},
"timestamp": "2026-08-05T09:34:00.000Z"
}注意事项
- 无需人工框选擦除区域,适合电商搬家、商品图净化和素材二次创作。
- 平台固定扣 0.8 积分/成功次;上游请求失败时自动退回积分。
- 火山官方按成功处理次数计费,标价为 41.4 元/千次,即 0.0414 元/次。
- 后台最多等待火山处理 5 分钟,超过 5 分钟才会按超时失败并退款。
- 火山结果地址有效期为 24 小时,请及时保存产物。
- 提交接口不会等待火山处理完成;返回 taskId 后请通过获取结果接口轮询。
