上传图片，自动识别主体、移除背景并输出透明 PNG。
0.03积分/次基础说明
上传图片，自动识别主体、移除背景并输出透明 PNG。
提交任务
提交一键透明底任务。平台会自动识别图片主体、移除背景并输出透明 PNG。
POST/api/third-party/subjectExtract/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/subjectExtract/generate" -H "X-API-Token: your_token" -H "Content-Type: application/json" -d '{"image":"https://your-cdn.com/product.png","scene":"general"}'响应字段
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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", "cost": 0.03 } }注意事项
- 图片需为公网可访问的 HTTP/HTTPS URL，单张不超过 10 MB。
- scene 支持 general、human、product；未传时默认 general，输出格式固定为支持透明背景的 PNG。
- 火山临时结果地址有效期为 24 小时；平台会立即转存，稳定结果请通过获取结果接口查询。