Twitter Video Transcript
X(原 Twitter)上的视频把采访、公告、产品演示和评论放在口播里,转录稿把这些语音写成纯文本,并附上视频的时长(秒)。语音变成文字后,就可以原样引用、做摘要、翻译,也能用分析文字帖子的关键词和话题方法来检索。
Twitter Video Transcript API 主要特性
- 按链接提交视频帖子传入一个或多个带视频的推文链接,格式为 x.com/{username}/status/{post_id},每个视频返回一行,带有帖子的 id 和 url。
- 连续的纯文本语音内容text 把视频里说的话写成一整段纯文本,format 为 "text",文字使用说话人所用的语言。
- 每份转录都附带视频时长duration_seconds 给出视频的时长,可以按长短给视频排序,也能衡量一段视频里说话的密度。
Twitter Video Transcript API 参数
| 参数 | 必填 | 描述 |
|---|---|---|
urls | 必填 | 一个或多个 X 帖子链接,格式为 /{username}/status/{post_id},每个链接指向一条带视频的帖子。 |
如何使用 Twitter Video Transcript API
提交视频帖子的链接,每个视频读取一份转录。
- 向 /v1/x/post-transcript 发送 {"urls": ["https://x.com/NASA/status/2119833829389041896"]}。
- 轮询 GET /v1/tasks/{task_id},status 为 succeeded 时转录就绪。
- 从 results.items 读取每份转录;has_more 为 true 时,用 results.next_cursor 读取剩余结果。
curl -X POST "https://api.socq.ai/v1/x/post-transcript" \
-H "Authorization: Bearer $SOCQ_API_KEY" \
-H "Content-Type: application/json" \
-d '{"urls":["https://x.com/NASA/status/2119833829389041896"]}'
# 2 分钟以内的视频计 0.7 积分;更长的视频每开始一分钟计 4 积分。Twitter Video Transcript API 最佳使用场景
- 引用视频里的原话: 从 text 中摘录原句并附上帖子 url,采访或新闻片段里的引语都能回到出处核对。
- 给视频帖子做摘要和翻译: 把 text 交给摘要或翻译模型,把较长的视频帖子整理成简短笔记,或转成其他语言。
- 在大量视频里检索口播内容: 为某个创作者或品牌的视频帖子建立转录索引,找出所有提到某款产品、某个人或某个话题的视频。
- 为视频配一份文字版: 在文章、邮件简报或帮助页面里把 text 放在视频下方,读者静音时也能看懂内容。
Twitter Video Transcript API 使用建议
- 长录像单独做预算:2 分钟以内的视频计 0.7 积分,一段 10 分钟的录像则要 40 积分,按完整时长每开始一分钟计费。
- 送去翻译前先检测 text 的语言,因为每份转录都使用视频里说话的语言。
- 拿不准哪些帖子带视频时,可以混在一起提交:带视频的返回转录,其余不扣积分;整批都是纯文字或图片帖子时,任务失败并全额退款。
相关 API
除了 Twitter Video Transcript API,需要其他类型的 X 公开数据时,可以使用以下 API。
- Twitter Tweet Scraper API — 从 x.com 或 twitter.com status URL 获取公开帖子正文、作者、互动、媒体、标签、提及和会话关系。
- Twitter User Tweets Scraper API — 按 username 采集近期公开帖子、作者、媒体、标签、提及和互动指标,并排除回复。
- X Post Quotes API — 按已知 status URL 采集公开引用帖,返回评论正文、作者、互动、媒体、时间和来源帖子上下文。
- X Post Replies API — 从 X 帖子 URL 采集公开回复,支持选择排序,并返回回复正文、作者、可见互动、媒体和父帖信息。
- Twitter Mentions API — 采集提及指定账号的公开帖子。
- Twitter Media Scraper API — 采集账号发布的图片、视频和 GIF 帖子,附带最高画质的媒体文件。
- Twitter Profile Scraper API
- Twitter Search API
- X Followers List API
- X Following List API
- X Post Retweeters API
- X Trends API
- Twitter User Search API
- X Community API
- X Community Posts API
- X Thread Context API
- X Account Location API
- X Verified Followers API
- X List Tweets API
- Twitter List Members API
- Twitter List Followers API
- X Community Members API
- X Community Moderators API
- X Communities Search API
- X Articles API
- X Spaces API
- X User Replies API
- Twitter Follow Checker API