跳转到主要内容
POST
Twitter 视频转文字

Twitter 视频转文字

把 X 视频里的语音转成文字。传入带视频的帖子链接,即可返回纯文本形式的转录内容,以及视频时长(秒)。有了文字稿,视频内容就能检索、能引用:摘出采访片段里的原话、总结产品演示、翻译一段演讲,或者把口播内容放进你对文字帖子已有的分析流程里。
通过 urls 提供带视频的 X 帖子链接,路径格式为 //status/。每个视频返回语音文字和时长。2 分钟以内的视频按 0.7 积分计费;超过 2 分钟的视频按完整时长每开始一分钟计 4 积分,例如 3 分钟的视频计 12 积分。不含视频的帖子不返回结果,也不扣积分。

标准结果字段

任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式,但不会推断或补充来源未提供的数据。如需缩小返回字段集合,MCP 查询使用 fields,Typed 工具使用 _result_fields,CLI 使用 --result-fields。声明字段的值为 null 时仍会保留。 以下示例展示任务完成后的响应格式,具体数据以实际查询结果为准。

任务完成响应

授权

Authorization
string
header
必填

使用 Authorization: Bearer <token> 请求头进行身份验证。

请求体

application/json

通过 urls 提供带视频的 X 帖子链接,路径格式为 /{用户名}/status/{帖子ID}。每个视频返回语音文字和时长。2 分钟以内的视频按 0.7 积分计费;超过 2 分钟的视频按完整时长每开始一分钟计 4 积分,例如 3 分钟的视频计 12 积分。不含视频的帖子不返回结果,也不扣积分。

urls
string[]
必填

带视频的 X 帖子链接,格式为 https://x.com/{用户名}/status/{帖子ID},至少提供 1 项。

Minimum array length: 1
Minimum string length: 1
callback_url
string<uri>

可选的任务完成回调 URL。

响应

任务已受理

code
integer

HTTP 业务状态码。

data
object