剪狐 · TEXT REMOVAL API

视频去字幕 / 去水印 API

为你的应用接入视频硬字幕与文字水印去除,保留视频原声。支持局部、多区域及全画面处理,可用于短剧、电商等视频的自动化清理,按视频时长计费。

REST · https://unmarkai.cn/api/v1 · API 钱包独立于网页积分与会员

去字幕 API 的处理与计费方式

剪狐视频文字擦除 API 面向开发者,使用 API Key 创建异步 remove_text 任务,支持单框、多框、全画面选区。有充值或后台额度发放记录的 API 钱包可下载免剪狐水印的成片。

标准价
单框 ¥0.020/秒,多框或全画面 ¥0.040/秒,最低 15 秒。
接入流程
申请上传或导入公网 HTTPS 视频直链,创建任务,查询结果或接收 Webhook。
素材与选区
服务端核验素材、时长与绝对像素坐标;固定选区不自动跟踪物体。

真实效果

先看擦除效果,
再决定是否接入

五类真实素材与剪狐实际处理结果,原声保留。
播放前后同步的视频,留意背景与细节。

以上为剪狐擦除服务的真实处理结果(在网页工作台提交),对比视频仅做缩放、同步拼接、标签和编码。每个案例页记录来源、选区与处理条件。实际效果受文字大小、透明度、背景纹理、运动和遮挡面积影响,建议先用短片在 API 中核对自己的素材。

接入流程

接入流程:四步完成一次擦除

完整快速入门
  1. 01

    上传或导入原片

    调用 POST /uploads 获取直传凭证后 PUT 视频字节;或调用 POST /url-uploads 从公网 HTTPS 视频直链异步导入,等待 status=uploaded。支持 MP4、MOV、AVI、MKV、WebM、MPEG。

  2. 02

    创建 remove_text 任务

    调用 POST /jobs,传入 type=remove_text、upload_id、mode 与选区,并携带 Idempotency-Key。服务端核验素材、时长和选区,冻结足额余额后进入队列。

  3. 03

    查询进度或接收 Webhook

    轮询 GET /jobs/{job_id},或在控制台配置 HTTPS 接收地址接收任务事件;事件经 HMAC-SHA256 签名,收到后再查询任务获取最新状态。

  4. 04

    下载 result.url

    任务成功后下载 result.url。下载链接最长有效 1 小时,终态后保留 7 天,过期可在保留期内重新查询获取新链接。

擦除方式

按文字位置,选择擦除方式

选区使用源视频绝对像素坐标:左上 (x1,y1),右下 (x2,y2)。

mode 取值与计费
mode 适合的素材 rect 与说明
sel_area 单框 字幕或水印集中在一个固定区域 一个矩形,面积不超过源画面的一半;按单框费率计费。
multi_area 多框 文字分散在几个固定位置 非空矩形数组,每个矩形须在画面内;按全画面费率计费。固定选区,不做自动跟踪。
all_area 全画面 位置变化、难以用固定框覆盖的文字 rect 省略或 null;可能处理到本想保留的其他文字,建议先用短片核对。

计费方式

人民币 API 钱包,按秒计费

当前标准价;实际价格以 GET /balance 与任务金额为准。

单框擦除 sel_area

¥0.020 / 秒

折合 ¥1.20 / 分钟

多框 / 全画面擦除

¥0.040 / 秒

折合 ¥2.40 / 分钟

最低计费

15 秒 / 视频

每视频按秒向上取整

一个明确条件下的例子

10 秒视频,全画面擦除

不足 15 秒按 15 秒计,标准价为 ¥0.60。核验真实时长并冻结足额费用后开始处理;成功交付结算,未交付的失败或允许的取消释放费用。

¥0.60标准价 · 该示例条件下
微信单次充值 ¥200–10,000,1 元实付到账 1 元;API 钱包独立于网页积分、会员和试用。
近 365 天累计净充值达到档位可享折扣。
查看计费与折扣档位 ↗

快速开始

一个请求,创建擦除任务

擦除任务完整参数

上传完成后提交任务。密钥只放在服务端环境变量中,不要写进网页代码;每个新业务请求生成一次幂等键,重试时复用。

bashPOST /jobs
curl 'https://unmarkai.cn/api/v1/jobs' \
  -H "Authorization: Bearer $UNMARKAI_API_KEY" \
  -H 'Idempotency-Key: replace-with-a-unique-business-request-id' \
  -H 'Content-Type: application/json' \
  -d '{
    "type": "remove_text",
    "input": {"upload_id": "upl_REPLACE"},
    "mode": "sel_area",
    "rect": {"x1": 100, "y1": 80, "x2": 900, "y2": 220}
  }'

返回 202 与任务资源。上传、轮询、下载及 Python / JavaScript 示例见API 文档;完整契约见 OpenAPI。

MCP 接入

也可以通过 MCP 调用

MCP 接入说明
ENDPOINT

https://unmarkai.cn/api/mcp

在支持远程 HTTP MCP 的客户端中配置服务地址与 Bearer API 密钥。

TOOLS

覆盖擦除工作流

上传与直链导入、remove_text、查询与取消任务、余额与估价。视频翻译目前通过 REST 提供。

常见问题

去字幕 API 常见问题

更多细节见 API 文档。

API 和网页工作台共用积分或会员吗?

API 使用独立的人民币钱包,按完整时长计费。实付充值到账或获发 API 额度后,成片免剪狐水印。

怎么提交视频,支持哪些格式?

本地文件通过 POST /uploads 获取直传凭证后上传;已有公网 HTTPS 视频直链时调用 POST /url-uploads 异步导入。支持 MP4、MOV、AVI、MKV、WebM、MPEG,最大 2 GiB、60 分钟。网页或平台分享页不能作为直链。

单框、多框、全画面怎么选,价格有何不同?

文字集中在一个固定区域用 sel_area,标准价 ¥0.020/秒;分散在几个固定位置用 multi_area,位置变化难以固定时用 all_area,二者均为 ¥0.040/秒。每视频按秒向上取整,最低 15 秒。

任务完成后怎么得到通知?

可以轮询 GET /jobs/{job_id},也可以在 API 控制台配置 HTTPS 接收地址。事件带 HMAC-SHA256 签名,不含下载链接;验签后调用查询接口获取 result.url。

请求超时或网络错误,会不会重复扣费?

创建任务必须携带 Idempotency-Key。网络断开或响应丢失时,用原键和原请求体重试,24 小时内服务端重放同一任务;重试时不要生成新键,否则可能创建多个计费任务。客户端等待超时不等于任务失败,保留 job_id 继续查询即可。

余额不足会怎样?

申请上传前需具备至少一次最低计费余额。任务在核验真实时长后冻结足额费用;未交付的失败或允许的取消会释放冻结金额。实时余额和价格通过 GET /balance 查询。

可以在 AI 助手里调用擦除吗?

可以。在支持远程 HTTP MCP 的客户端配置 https://unmarkai.cn/api/mcp 与 API 密钥,即可使用上传、remove_text、查询与估价等工具。翻译目前仅通过 REST 提供。

YOUR PIPELINE. A CLEANER CANVAS.

从第一个请求,
接入视频擦除

内容维护:剪狐 · 更新于