x/
post-transcript

提交帖子链接即可把 X 视频里的语音转成文字,返回纯文本形式的转录内容和以秒计的视频时长,一次请求可以处理多条帖子。

Twitter Video Transcript API

帖子链接输入
纯文本转录
以秒计的时长
每条结果 0.7 积分
等待提交
等待提交

填写参数并发送请求,任务状态和标准化结果会显示在这里。

README

由 SocQ 维护 · 更新于

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

提交视频帖子的链接,每个视频读取一份转录。

  1. 向 /v1/x/post-transcript 发送 {"urls": ["https://x.com/NASA/status/2119833829389041896"]}。
  2. 轮询 GET /v1/tasks/{task_id},status 为 succeeded 时转录就绪。
  3. 从 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 的语言,因为每份转录都使用视频里说话的语言。
  • 拿不准哪些帖子带视频时,可以混在一起提交:带视频的返回转录,其余不扣积分;整批都是纯文字或图片帖子时,任务失败并全额退款。

除了 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 帖子,附带最高画质的媒体文件。

探索其他平台

还可以将 X 数据与其他已支持社交平台的公开数据结合使用。

Twitter Video Transcript API — 常见问题

Twitter Video Transcript API 是一个用于根据帖子链接把 X 视频中的语音转成文字的 API。它为每个视频返回纯文本转录和以秒计的视频时长。

复制帖子链接放进 urls(一次请求可以放多个链接),任务成功后从 text 读取转录内容。

没有。每个视频返回一份纯文本转录,format 为 "text",另附视频总时长 duration_seconds,没有逐句时间。

2 分钟以内的视频计 0.7 积分。更长的视频按完整时长每开始一分钟计 4 积分,例如 3 分钟的视频计 12 积分。

转录使用视频里说话的语言。结果不带语言标记,工作流需要时可以根据 text 自行检测。

不含视频的帖子不返回结果,也不扣积分。提交的帖子都不含视频时,任务失败并全额退款。