XRToken API 文档

创建字幕擦除任务

API 配置
保存后下方「Try It」面板会自动携带此 API Key 发送真实请求。
Base: api.xrtoken.net

对已生成的视频做 AI 精细化字幕擦除,异步返回任务 ID。

完成通知 —— 二选一

  • callback_url → 任务终态时 XRToken 主动 POST 通知你,无需轮询
  • 不配 → 自行 GET /v1/videos/erase-subtitle/{taskId} 轮询结果

输入约束:只能擦除通过 XRToken 生成的视频,且生成时间 < 23 小时。调用方传 video_task_id,其他的 XRToken 处理。

擦除耗时:不排队情况下一般 20–30 分钟内完成;高峰排队时 可能延长到 2–3 小时。建议使用 callback_url 避免长轮询。

支持擦除的字幕

  • 垂直位置:画面 下半部分 的横向字幕
  • 字号:单字竖向高度为视频高度的 1% – 10%
  • 语言:中文 / 英文

不支持(以下情况不会被擦除):

  • 位于画面 上半部分 的字幕
  • 字号过小(< 1% 高度)或过大(> 10% 高度)
  • 中英文之外的语言 / 无法识别语种的文本

可能误擦的场景:画面下半部分出现的符合尺寸阈值的场景文本 (例如条幅、招牌文字)也会被识别为字幕一并擦除。建议调用方 在上游视频生成阶段就控制这类文本的出现位置。

计费:按视频秒数计费;当前免费推广期,每次调用产生 ¥0.00 的 消费记录(可在账单页查询)。擦除完成后,结果视频自动写入素材库, 与原视频并列展示。

POST
/v1/videos/erase-subtitle

Authorization

BearerAuth
AuthorizationBearer <token>

API 密钥认证(OpenAI 格式)。在 Authorization 请求头中传入:

Authorization: Bearer tr-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X post "https://api.xrtoken.net/v1/videos/erase-subtitle" \  -H "Content-Type: application/json" \  -d '{    "video_task_id": "7d4f9e4a-2c1b-4e3a-8a9f-1b2c3d4e5f60"  }'
{
  "id": "string",
  "upstream_id": "string",
  "status": "processing",
  "created_at": "2019-08-24T14:15:22Z"
}
{
  "error": "model field is required",
  "type": "invalid_request_error"
}
{
  "error": "invalid or missing API key",
  "type": "auth_error"
}
{
  "error": "insufficient balance -- please top up or upgrade your plan",
  "type": "billing_error"
}
{
  "error": "rate limit exceeded",
  "type": "rate_limit_error"
}
{
  "error": "upstream provider error",
  "type": "server_error"
}