一场 YouTube 讲座里有几段你想反复读,手动拖进度条很费时间。你需要的是可回到视频位置的文字材料,而不是凭标题生成一份似乎很完整的内容摘要。

先确认视频和可用语言

用 video_id 获取视频信息,核对主题与原链接。调用字幕接口时不传 language_code 可查询可用字幕列表;先看实际有哪些语言,再选择需要的一种,不假定任何视频都有中文。保留语言代码与来源,不能把自动字幕或翻译材料默认为作者审定的文稿。

复习用途决定字幕格式

想边读边回看可选择带时间轴的 srt,单纯整理阅读材料可用 txt。文档还列出 xml 与 json3,按自己的处理需求选择。纯文本没有时间轴,后续若要引用某一段,就不能凭文本顺序猜精确时间;需要位置时保留相应格式与原视频链接。

处理中不是没有结果

较大视频可能返回 processing 和 job_id,此时用结果接口查询该任务。遇到 queued 或 active 说明仍在排队或处理,按说明稍后查询,不重新提交许多相同任务。真正没有字幕时,如实记录缺口;当前流程不是语音识别服务,不能自动把无字幕视频转写成新文稿。

摘要和字幕分成两份资料

拿到文字后保留原始版本,另写自己的主题索引与学习笔记。AI 可帮助整理,但术语、人名和关键数字应回到视频核对,摘要不能冒充逐字原文。记录表可列来源、字幕语言、格式、任务状态、回看位置和待核实词句。完成后你应能从笔记回到对应讲解,知道哪些是视频现有文字、哪些是自己的理解,而不是拿一份生成的总结代替讲座本身。

这篇用到的接口

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/youtube/web_v2/get_video_info

参数 类型 必填 含义
video_id string 是 视频ID
language_code string 否 语言代码(如zh-CN, en-US等)
need_format boolean 否 是否需要清洗数据,提取关键内容,移除冗余数据

可以复制的 Python 请求

安装 requests 并在环境变量中设置 TRMESH_API_TOKEN。把示例用户名或作品 ID 换成你要查询的对象。

import os
import requests

# 使用自己的 TRMesh 开发者密钥;不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/youtube/web_v2/get_video_info"
params = {
    "video_id": "oaSNBz4qMQY",
    "language_code": "zh-CN"
}
response = requests.get(
    url, params=params, timeout=30,
    headers={"Authorization": f"Bearer {os.environ['TRMESH_API_TOKEN']}"},
)
response.raise_for_status()
payload = response.json()
print(payload)  # 先核对真实响应,再提取业务字段

对应接口文档 · 返回免费查询工具

调用接口会使用你的 TRMesh 账号额度,运行前请确认接口价格。