视频字幕提取
SpiderHubs OpenAPI 文档:视频字幕提取,分类 字幕提取。支持 TikTok、抖音、小红书、视频号和 YouTube。 视频号传分享链接 https://weixin.qq.com/sph/… 。YouTube 传 watch、shorts 或 youtu.be 视频链接。没有自带字幕时会尝试...
OpId:
subtitle-extract · 最近更新: 2026-11-191. 接口概览
支持 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}
提交与轮询都要带
只在 POST 成功入队时扣 2 积分;4xx / 5xx 不扣。轮询接口不计费。
Authorization: Bearer sk_live_…。只在 POST 成功入队时扣 2 积分;4xx / 5xx 不扣。轮询接口不计费。
3. 请求参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| url | string | 是 | 视频 / 笔记链接(含分享短链)。必填 |
| platform | string | 否 | tiktok / douyin / xhs(或 xiaohongshu)/ wechat_video_channel / youtube。可不传,服务端按 url 域名识别 |
| content_id | string | 否 | 平台内容 ID。可不传,服务端从 url 解析 |
| play_addr | string | 否 | 可选。视频文件直链;不传则由服务端自行获取 |
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 小时。
POST 成功入队固定 HTTP 202,status=queued。GET 在 queued / processing 时也是 202,终态(done / no_subtitle / failed)返回 200。
建议间隔 2–5 秒轮询,结果保留 1 小时。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| task_id | string | 是 | 任务 ID,用于轮询 |
| status | string | 是 | queued / processing / done / no_subtitle / failed |
| platform | string | 是 | 归一化后的平台:tiktok / douyin / xhs / wechat_video_channel / youtube |
| content_id | string | 是 | 从 url 解析出的内容 ID |
| subtitle | string | 是 | 字幕纯文本。未完成或无字幕时为 "" |
| lang | string | 是 | 语言代码,如 zh / en。未完成时为 "" |
| source | string | 是 | 字幕来源标识。未完成时为 "" |
| error | string | 是 | 失败原因。非 failed 时为 "" |
| elapsed_sec | integer | 是 | 提取耗时,单位秒。未完成时为 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 调用接口。