Company Logo
首页/开放能力
imageErase

智能移除

自动识别并移除图片中的全部文字、指定文字或常见图标，并智能修复背景。

0.03积分/次

基础说明

自动识别并移除图片中的全部文字、指定文字或常见图标，并智能修复背景。

提交任务

提交智能移除任务。可自动擦除图片中的全部文字、指定文字或常见图标，并修复擦除区域。

POST/api/third-party/imageErase/generate

请求头

字段类型必填说明
X-API-Tokenstring是平台提供的调用凭证，用于识别当前账号或租户。
Content-Typestring是提交任务时固定使用 application/json。

请求参数

字段类型必填说明
image_urlstring是待处理图片 URL：支持公网 HTTP/HTTPS；分辨率 10×10 至 2560×1440；单张不超过 10 MB；支持 png、jpg、jpeg、webp、tiff、bmp、heic。
tool_versionstring否图像擦除修复模型版本，当前仅支持 standard，默认 standard。
standard_scenestring否标准版擦除场景：full_screen_text_erase（默认，全屏文字）或 full_screen_icon_erase（全屏图标）。
standard_erase_textstring否指定要移除的文字；仅在 standard_scene 为 full_screen_text_erase 时生效，不传则移除识别到的全部文字。
output_formatstring否输出格式：webp、png 或 jpeg，默认 png。

请求示例

bash
curl -X POST "https://yunfanzhilian.com/api/third-party/imageErase/generate" \
  -H "X-API-Token: your_token" \
  -H "Content-Type: application/json" \
  -d '{
    "image_url": "https://your-cdn.com/product-with-text.png",
    "tool_version": "standard",
    "standard_scene": "full_screen_text_erase",
    "standard_erase_text": "内部资料",
    "output_format": "png"
  }'

响应字段

字段类型必填说明
codenumber-业务状态码，200 表示请求成功。
messagestring-本次请求的结果说明。
data.taskIdstring-任务 ID。提交成功后请保存，用于查询生成结果。
data.costnumber-本次提交预扣积分。
data.statusstring-任务初始状态，通常为 pending 或 processing。
timestampstring-响应时间，ISO 8601 格式。

响应示例

json
{
  "code": 200,
  "message": "智能移除任务已提交",
  "data": {
    "taskId": "task_xxxxxxxx",
    "status": "pending",
    "image_url": "https://your-cdn.com/product-with-text.png",
    "tool_version": "standard",
    "standard_scene": "full_screen_text_erase",
    "image": "https://your-cdn.com/product-with-text.png",
    "scene": "full_screen_text_erase",
    "cost": 0.03
  },
  "timestamp": "2026-03-31T09:34:00.000Z"
}

注意事项

  • 当前使用火山 AI MediaKit 标准版图像擦除修复，不需要调用方制作涂抹蒙版。
  • 文字场景可移除全部文字或通过 standard_erase_text 指定文字；图标场景自动移除常见图标。
  • 旧字段 image、scene、eraseText、outputFormat 仍可兼容，建议新调用统一使用官方字段名。
  • 火山结果地址仅保留 24 小时，服务端会在提交阶段立即转存。
  • 为兼容统一任务协议，提交接口仍返回 taskId，结果通过获取结果接口读取。