按数据类型找接口
字幕接口
4 个平台的 4 个接口，用同一个 Transcript 对象返回字幕。视频里说了什么，按时间分段返回，同时给出整段纯文本，并注明返回的字幕语言。每次 $0.002 到 $0.004，各接口按自己的价格计费；失败的调用不扣费。
字幕 · 各平台接口
| 平台 | 接口 | 路径 | 每页 | 价格 |
|---|---|---|---|---|
| YouTube | YouTube 视频字幕 | GET /v1/youtube/videos/transcript/get | 1 | $0.004/次 |
| Instagram 视频字幕 | GET /v1/instagram/posts/transcript/get | 1 | $0.004/次 | |
| Reddit 视频字幕 | GET /v1/reddit/posts/transcript/get | 1 | $0.004/次 | |
| TikTok | TikTok 视频字幕 | GET /v1/tiktok/videos/transcript/get | 1 | $0.002/次 |
每次 $0.002 到 $0.004，各接口按自己的价格计费。失败的调用不扣费。
返回的对象: Transcript
上面每个接口返回的字段名和类型都一样。平台不展示的字段返回 null，并在 meta.unavailable 里注明。
| 字段 | 类型 | 含义 |
|---|---|---|
video_id | string | 视频 ID。 |
lang | string | 字幕语言。 |
segments | Segment[] | 按时间排列的字幕段。 |
text | string | 全部字幕拼成的纯文本。 |
两个平台上的同一个调用
参数一样、翻页方式一样、返回结构一样，只换路径。
# YouTube
curl -G "https://api.okdata.online/v1/youtube/videos/transcript/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=dQw4w9WgXcQ'
# Instagram
curl -G "https://api.okdata.online/v1/instagram/posts/transcript/get" \
-H "Authorization: Bearer $OKDATA_API_KEY" \
--data-urlencode 'id=DeCPVhERA8e'常见用途
- 不看视频也能总结长视频的内容。
- 把一个频道的演讲建成索引，用于搜索或 RAG 问答。
- 从一批测评视频里找出提到某个产品的每一处。
常见问题
- 视频没有字幕怎么办？
- 调用返回 not_found，不扣费。Instagram 的接口只支持两分钟以内的视频；各平台的限制写在对应的接口页上。
- 能指定语言吗？
- YouTube 可以用 lang 指定想要的字幕语言，结果里的 lang 是实际拿到的那一条。其他平台返回它们现有的字幕。
- 有时间戳吗？
- 有。segments 里每一段都有开始、结束时间（秒）和文字，text 是全部拼起来的纯文本，既能引用某个时刻，也能整段交给模型。