# AI 智能体 视频转录，用于检索、引用和总结

> 通过MCP、Agent Skill（SKILL.md）或REST API接入AI 智能体 视频转录，获取视频链接或录音的带时间戳文本。长文本可分页读取。

Canonical: https://transcript1.com/zh/use-cases/ai-zhinengti-shipin-zhuanlu
Language: zh-Hans
Last updated: 2026-10-19

把AI 智能体 视频转录接入现有流程，先获取带时间戳的文本，再交给模型检索、引用或总结。可通过MCP、Agent Skill或REST接入。支持YouTube、X、TikTok、Instagram、Facebook、Bluesky、Dailymotion和LinkedIn视频，以及Twitch剪辑和已结束直播的VOD、Pinterest视频Pin、Snapchat Spotlight视频，也可上传录音。

- MCP服务器提供8个工具
- Agent Skill通过SKILL.md提供使用说明
- 长文本分页返回，便于控制上下文长度

## 拿到文本，也读完该读的内容

### 直接接入MCP客户端

Claude、ChatGPT、Cursor、VS Code和Claude Code可连接https://api.transcript1.com/mcp，直接调用转录工具。

### 给智能体一份使用说明

SKILL.md说明如何连接、调用工具，以及避免重复创建任务。llms.txt则提供API文档入口。

### 按页读取，不挤满上下文

MCP默认按文本片段逐行返回，每行带时间戳。分页不会截断片段；还有后文时，返回next_from_seconds。

### 能继续读取，就不重新转录

使用完整链接时，transcribe会复用24小时内同一视频、相同选项的转录。短链接无法这样匹配。已有任务ID时，直接调用get_transcription。

### 后台流程用REST

批量处理可使用同一套API，通过Webhook接收完成通知，再读取JSON片段和逐词时间戳。

## 创建1次任务，之后只跟进ID

调用transcribe后，工具会等待转录并返回第1页。如果任务还没完成，保存返回的id，改用get_transcription查询。2个工具的参数见[MCP工具文档](https://transcript1.com/zh/docs/mcp#tools)。

给智能体明确区分“创建任务”和“读取任务”。前者会开始转录，可能消耗分钟数；后者用于查看进度或读取已有文本。不要用重新提交来代替查询。

把任务ID写入持久化任务状态，不要只留在模型的对话里。智能体重启后，仍应能接着读取。处理一组视频时，每个ID都保留对应的输入链接。

完整帖子链接可以匹配近期相同选项的转录，短分享链接在提交时无法匹配。知道ID就直接读取，这是避免重复任务最简单的办法。下面的例子使用公开Bluesky视频帖子的链接占位符。

### MCP工具调用示例

```
transcribe(url="[public bsky.app video-post URL]")

get_transcription(id="tr_8fK2Lm0PqRsTuVwXyZaBcD", from_seconds=900)
```

## 让智能体知道怎么用这些工具

支持Agent Skill的智能体可以从索引发现transcript1，再读取SKILL.md中的使用说明。

MCP提供可调用的工具，Agent Skill说明调用顺序和错误处理方式。自行搭建REST流程时，也可以沿用相同的任务生命周期，不必先接入MCP客户端。llms.txt只是文档入口，不会收集转录文本。

交互式助手适合用MCP分页读取；后台采集服务适合用REST提交任务，再接收带签名的完成Webhook。2种方式共用账号限制和转录分钟数，控制并发时要把所有客户端一起计算。

### Agent Skill索引与说明文件

```
https://transcript1.com/.well-known/agent-skills/index.json
https://transcript1.com/.well-known/agent-skills/transcript1/SKILL.md
```

## 把带出处的文本交给LLM

通过[API读取带时间戳的文本](https://transcript1.com/zh/docs/api-reference#get-a-transcription)，再交给模型。MCP长文本应分多页读完；REST批量任务可用[Webhook](https://transcript1.com/zh/features/zhuanlu-webhook)接收通知。

搭建LLM 转录 管道时，把源链接、任务ID和片段的起止时间一起保留。只给模型一段脱离出处的文字，后续就很难回到录音核对。做检索时，按完整片段或话题切分，不要从词语或一次发言中间截断。

总结和信息提取由助手完成，不是transcript1的转录功能。要求模型分清直接引用和转述，并注明原文没有提供的信息。Instagram演示视频可能只在画面里展示操作，模型不能从转录文本猜出这些步骤。

### cURL

```
curl "https://api.transcript1.com/v1/transcriptions/tr_8fK2Lm0PqRsTuVwXyZaBcD?format=text&timestamps=true" \
  -H "Authorization: Bearer $TRANSCRIPT1_API_KEY"
```

## 总结整段视频前，确认读到了结尾

只要返回next_from_seconds，就还有后文。把它作为下一次调用的from_seconds，继续读取，并记录已经读过的页。第1页可能只有开场介绍，不能据此声称分析了整段视频。

长录音先逐页整理证据，再汇总。中间笔记保留时间戳，留意后文有没有修正观点或补充限制条件。比较多个来源时，列明读完了哪些录音、哪些读取失败，不要把无法访问的来源当成赞同或没有证据。

- [读取Bluesky视频的转录文本](https://transcript1.com/zh/features/bluesky-shipin-zhuan-wenzi)
- [Instagram视频里哪些信息不在文本中](https://transcript1.com/zh/features/instagram-reels-zhuan-wenzi)

## 分清输入有问题，还是任务还在运行

遇到login_required或no_audio，需要更换或修正输入；任务仍在运行，则继续查询状态。把这2种情况明确传给用户或上层流程。读取失败不能写成空转录文本，否则模型可能误以为录音里没有人说话。

本地文件需要能上传文件的运行环境。MCP负责预留上传和确认完成，文件字节通过MCP之外的HTTP PUT发送。如果助手做不到，让用户先在控制台上传，再用生成的任务ID读取转录文本。

- [查看MCP分页、默认选项与文件上传说明](https://transcript1.com/zh/docs/mcp)

## 常见问题

### 哪些AI助手可以接入？

支持远程服务器的MCP客户端都可以，包括Claude、ChatGPT、Cursor、VS Code和Claude Code。能读取SKILL.md的智能体也可以使用Agent Skill。

### 智能体怎么登录账号？

Claude和ChatGPT通过OAuth登录。其他智能体可以使用以t1_开头的API密钥，作为Bearer Token发送。

### 转录文本太长，超出上下文怎么办？

按页读取。每页在完整片段处结束；还有后文时会返回next_from_seconds。智能体把这个值作为from_seconds继续请求下一页。

### 重试会再扣费吗？

使用完整视频链接时，transcribe会复用24小时内同一视频、相同选项的转录，不再扣费。短链接无法这样复用。已有任务ID时，用get_transcription查询或读取，不会创建新转录，也不会新增费用。

### 可以让Claude总结YouTube视频吗？

可以。transcript1通过MCP提供转录文本，Claude读完后再写总结。也可以把同一份文本交给自己的LLM流程处理；transcript1本身不生成摘要。

## 相关内容

- [MCP转录](https://transcript1.com/zh/features/mcp-zhuanlu)
- [MCP服务器接入指南 （文档）](https://transcript1.com/zh/docs/mcp)
- [Webhook通知](https://transcript1.com/zh/features/zhuanlu-webhook)
- [TikTok转文字](https://transcript1.com/zh/features/tiktok-shipin-zhuan-wenzi)