rgj1980298/obsidian_sync_public/asr-transcribe
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
语音识别(ASR)。将音频文件转为文字,支持 SiliconFlow API、OpenAI API、本地 faster-whisper 三种方式。
Install
npx vskill@latest install rgj1980298/obsidian_sync_public/asr-transcribeSKILL.md
语音识别 (ASR)
将音频文件转为文字。支持三种方式:SiliconFlow API(免费)、OpenAI API、本地 faster-whisper。
使用场景
- 音频/视频转文字
- 会议录音、课程视频字幕生成
- 「把这个音频转成文字」「语音转文本」「视频字幕提取」
前置条件
API Key 存储在 ~/.config/agent-skills/api-keys.json:
执行 ASR 前先读取此文件获取 API Key。
三选一:
| 方式 | 需要 | 特点 | |
|---|---|---|---|
| SiliconFlow API | API Key | 免费额度,推荐 | |
| OpenAI API | API Key | 需付费 | |
| 本地 faster-whisper | GPU 推荐 | 离线可用,首次需下载模型 |
输出位置
默认输出 .txt 到输入音频所在目录。如需指定输出路径,问用户确认。
方式 A:SiliconFlow API(推荐)
认证
调用
参数
| 字段 | 必需 | 说明 | |
|---|---|---|---|
model | 是 | FunAudioLLM/SenseVoiceSmall | |
language | 否 | zh 中文 / en 英文 / 省略自动检测 | |
file | 是 | 音频文件(WAV/MP3/M4A/FLAC/OGG/AAC) |
响应
Python 调用
方式 B:OpenAI Whisper API
响应格式与 SiliconFlow 相同。
方式 C:本地 faster-whisper
安装
调用
模型选择
| 模型 | 大小 | 速度 | 质量 | |
|---|---|---|---|---|
tiny | ~75MB | 最快 | 一般 | |
base | ~150MB | 快 | 可用 | |
small | ~500MB | 中等 | 较好 | |
large-v3-turbo | ~1.5GB | 较慢 | 最佳 |
initial_prompt 的作用
initial_prompt 是提示词,引导模型输出风格。上面的提示词让模型倾向输出中文标点和完整句子,避免碎片化断句。
设备选择
批量处理
常见问题
401 Unauthorized
API Key 无效或过期。
500 Internal Server Error
音频文件可能损坏或格式不支持。确保是有效音频文件。
识别结果乱码
- 确保音频是有效格式(WAV 最佳)
- 本地 Whisper 设置
initial_prompt引导中文标点 - 音频质量差可先降噪:
ffmpeg -i in.wav -af "highpass=f=200,lowpass=f=3000" out.wav
API 超时
音频太长,加大 timeout 或分段处理。
本地模型下载慢
设置 HuggingFace 镜像:
Security
- Security scanPassed, 90 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingfor-llm-using/skills/asr-transcribe/SKILL.md
Popularity
- 7-day trend score
- 0
Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/rgj1980298/obsidian_sync_public/asr-transcribe)