上传商品图，自动生成干净白底图，适合电商主图、货盘素材和商品入库。
0.03积分/次基础说明
上传商品图，自动生成干净白底图，适合电商主图、货盘素材和商品入库。
提交任务
提交一键白底图任务。适用于商品图自动抠图/换白底，完成后返回白底结果图。
POST/api/third-party/whiteBgImage/generate
请求头
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| X-API-Token | string | 是 | 平台提供的调用凭证，用于识别当前账号或租户。 |
| Content-Type | string | 是 | 提交任务时固定使用 application/json。 |
请求参数
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| image | string | 是 | 原始商品图 URL，需为公网可访问的 HTTP/HTTPS 图片地址。 |
| scene | string | 否 | 抠图场景：general（通用主体）、human（人像）或 product（默认，商品）。 |
请求示例
bash
curl -X POST "https://yunfanzhilian.com/api/third-party/whiteBgImage/generate" \
-H "X-API-Token: your_token" \
-H "Content-Type: application/json" \
-d '{
"image": "https://your-cdn.com/product.png",
"scene": "product"
}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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": "https://your-cdn.com/product.png",
"cost": 0.03
},
"timestamp": "2026-03-31T09:32:00.000Z"
}注意事项
- 图片建议使用清晰的商品主体图，并确保 URL 可公网访问。
- scene 支持 general、human、product；未传时默认 product。
- 平台会先生成透明图、铺设纯白背景并持久化；结果通过 taskId 从获取结果接口读取。