准备学剪辑时，你收藏了不少 B 站视频：软件入门、快捷键介绍、调色演示混在一起。现在只想挑出今晚该看的那一条。先给收藏补一张资料卡，再根据自己的基础安排顺序，比按标题里的“速成”两个字决定更实用。

BV 号指向视频，不指向学习目标

接口要求 bv_id，文档示例为 BV1M1421t7hT。保留标识原样，把原视频链接放在旁边。不要将数字形式的其他标识直接当成这个参数，也不要用作者名称替代。先查一条已知收藏，确认对象后再继续整理。查询只是帮助定位作品，适不适合初学者仍要看具体讲解。

返回什么，就先记录什么

当前契约概括返回视频详情信息，未展开保证全部业务字段。检查实际响应后，保存确实存在且有助于学习安排的信息。不存在的内容写“未取得”，不要根据标题猜时长、软件版本或课程章节。自己的资料卡可以包含来源、查询日期、已核对内容、需要的基础、打算观看的顺序；后面两项通常需要人工阅读或观看才能填写。

看几分钟，验证是否适合今晚

打开原视频，判断是否先介绍工作区，是否需要你已会导入素材，是否使用与你相同的软件版本。将“适合第一次打开软件”与“适合已经会剪辑的人”分开。这里的判断是你的学习备注，不是接口评分。详情查询也不自动提供完整字幕、分段摘要或视频文件，不能把这些能力写进已完成清单。

给明天的自己留下下一步

一条有用的备注可以写“先看界面介绍，完成一次素材导入，再决定要不要继续调色部分”。这是练习安排示例，不代表某个真实视频具有这些章节。遇到返回不完整的作品，保留原链接等待人工核对，不必编满所有栏目。完成后的收藏清单应告诉你先看什么、为什么看、还缺什么准备；即使视频很多，也能从一个明确动作开始。

完整地址与参数

GET https://api.trmesh.com/openapi/api/v1/bilibili/web/fetch_one_video

参数 类型 必填 含义
bv_id string 是 作品id

可以复制的 Python 请求

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

import os
import requests

# 使用自己的 TRMesh 开发者密钥；不要将密钥写入网页。
url = "https://api.trmesh.com/openapi/api/v1/bilibili/web/fetch_one_video"
params = {
    "bv_id": "BV1M1421t7hT"
}
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 账号额度，运行前请确认接口价格。