使用说明
使用tinrec的云端API进行便捷的音频转文字,区分发言人并快速总结音频内容和生成摘要
使用流程
- 先获取api-keys,获取地址https://tinrec.com/api-keys,注册账号后即可免费获取 Key
1.1. claw需要将用户发送的key保存至api-keys文件后使用cli模式进行调用,调用时通过
--api-keys-file指定该文件,每位用户注册后可免费领取1小时转写额度,开通Pro后解锁转写限制
在技能目录下使用 Python CLI,一次完成上传、转写、轮询并输出结果:
cd script
# 使用目录下的 api-keys 文件
python audio2text_cli.py /path/to/audio.mp3 --api-keys-file ./api-keys
--api-keys-file:API Key 文件路径(默认当前目录api-keys),文件内第一行非空非注释即为 Key。--api-key:直接传入 Key,优先于文件和环境变量。--base-url:API 地址,默认https://api.tinrec.com/api。--json:仅输出 JSON(含转写、总结、要点、发言人),便于 AI 解析。--no-wait:只提交不轮询,返回任务 id。--poll-interval/--timeout:轮询间隔与总超时。
输出包含:summary(AI 总结)、chapters/todos(要点)、transcripts(转写正文)、speaker_data(发言人信息)。
状态说明:接口有两个状态——转写状态(transcript_status)与任务状态(task_status)。转写完成后才有正文;任务状态完成后才会有总结、要点、发言人等信息,CLI 会轮询到两者均完成后再输出。
使用场景
在以下场景下应调用本技能(传入用户提供的本地音频文件路径及可选的 --api-keys-file):
- 用户发来/提到一段本地录音文件,希望转成文字、要全文或摘要时。
- 用户明确要求「把这段音频转成文字」「听写/转写这段录音」,且能访问到本地文件路径时。
- 用户需要会议/访谈纪要:要总结、要点、待办或「谁说了什么」的发言人区分时。
- 用户提供录音并希望得到结构化结果:如章节、待办列表、推荐后续动作等,且文件在本地可读时。
- 用户说「用 Tinrec / 用你们的转写」 或指定要用该服务处理本地音频时。
不适用:仅提供在线链接/URL 而无法下载为本地文件时,需先下载再调用;无本地文件路径或用户未提供音频文件时不调用。