OpenAPI 文档/字幕提取

视频字幕提取

SpiderHubs OpenAPI 文档:视频字幕提取,分类 字幕提取。支持 TikTok、抖音、小红书、视频号和 YouTube。 视频号传分享链接 https://weixin.qq.com/sph/… 。YouTube 传 watch、shorts 或 youtu.be 视频链接。没有自带字幕时会尝试...

OpId: subtitle-extract · 最近更新: 2026-11-19

1. 接口概览

支持 TikTok、抖音、小红书、视频号和 YouTube。视频号传分享链接 https://weixin.qq.com/sph/…。YouTube 传 watch、shorts 或 youtu.be 视频链接。没有自带字幕时会尝试语音识别。只要已有字幕正文、不做转写,用数据采集里的 YouTube「自带字幕」。
项值
计费2 积分 / 次(提交时扣;轮询免费)
限流10 次 / 分钟 / 用户
平台TikTok / 抖音 / 小红书 / 视频号 / YouTube
提交POST 入队后立刻返回 202

2. 基础信息

Submit:
POST /openapi/v1/subtitle/extract
Poll:
GET /openapi/v1/subtitle/tasks/{task_id}
提交与轮询都要带 Authorization: Bearer sk_live_…。
只在 POST 成功入队时扣 2 积分;4xx / 5xx 不扣。轮询接口不计费。

3. 请求参数

参数类型必填说明
urlstring是视频 / 笔记链接(含分享短链)。必填
platformstring否tiktok / douyin / xhs(或 xiaohongshu)/ wechat_video_channel / youtube。可不传,服务端按 url 域名识别
content_idstring否平台内容 ID。可不传,服务端从 url 解析
play_addrstring否可选。视频文件直链;不传则由服务端自行获取

4. 响应字段

提交 POST 和轮询 GET 返回同一份 JSON:9 个字段始终都在,只是值会变。未产出的字符串字段为 "",elapsed_sec 未完成时为 0。
POST 成功入队固定 HTTP 202,status=queued。GET 在 queued / processing 时也是 202,终态(done / no_subtitle / failed)返回 200。
建议间隔 2–5 秒轮询,结果保留 1 小时。
参数类型必填说明
task_idstring是任务 ID,用于轮询
statusstring是queued / processing / done / no_subtitle / failed
platformstring是归一化后的平台:tiktok / douyin / xhs / wechat_video_channel / youtube
content_idstring是从 url 解析出的内容 ID
subtitlestring是字幕纯文本。未完成或无字幕时为 ""
langstring是语言代码,如 zh / en。未完成时为 ""
sourcestring是字幕来源标识。未完成时为 ""
errorstring是失败原因。非 failed 时为 ""
elapsed_secinteger是提取耗时,单位秒。未完成时为 0
请求示例 · cURL
curl -X POST 'https://api.spiderhubs.com/openapi/v1/subtitle/extract' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "url": "https://www.tiktok.com/@user/video/7234567890123456789"
  }'

# 轮询
curl 'https://api.spiderhubs.com/openapi/v1/subtitle/tasks/<task_id>' \
  -H 'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxxxxxxxxxx'
响应示例
// POST 202 / GET 202(queued | processing)
{
  "task_id": "a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "status": "queued",
  "platform": "tiktok",
  "content_id": "7234567890123456789",
  "subtitle": "",
  "lang": "",
  "source": "",
  "error": "",
  "elapsed_sec": 0
}

// GET 200(done)
{
  "task_id": "a1b2c3d4e5f64789a1b2c3d4e5f64789",
  "status": "done",
  "platform": "tiktok",
  "content_id": "7234567890123456789",
  "subtitle": "今天给大家分享一个超好用的技巧……",
  "lang": "zh",
  "source": "native",
  "error": "",
  "elapsed_sec": 38
}

开始调用 SpiderHubs API

使用账户中心生成的 API Key,通过 Authorization: Bearer sk_live_xxx 调用接口。