Speech to Text
通过 miaoda-studio-cli speech-to-text 将音频文件转换为文字。
Quick Reference
| 参数 | 说明 | 必需 | 默认值 |
|---|---|---|---|
--file |
音频文件路径 | 是 | - |
--lang |
语言代码 | 否 | zh |
--output, -o |
输出格式: text/json | 否 | text |
支持的语言
| 代码 | 语言 | 代码 | 语言 |
|---|---|---|---|
zh |
中文（默认） | fr |
法语 |
en |
英语 | es |
西班牙语 |
ja |
日语 | pt |
葡萄牙语 |
ko |
韩语 | id |
印尼语 |
ru |
俄语 | ms |
马来语 |
使用示例
# 中文音频转文字（默认语言）
miaoda-studio-cli speech-to-text --file meeting.mp3
# 英文音频转文字
miaoda-studio-cli speech-to-text --file interview.wav --lang en
# 获取 JSON 格式输出
miaoda-studio-cli speech-to-text --file recording.mp3 --lang zh --output json
使用场景
| 场景 | 用法 |
|---|---|
| 会议录音转文字 | miaoda-studio-cli speech-to-text --file meeting.mp3 --lang zh |
| 外语音频转录 | miaoda-studio-cli speech-to-text --file audio.mp3 --lang en |
| 转录后搜索补充资料 | 先 miaoda-studio-cli speech-to-text 转录，再用 miaoda-studio-cli search-summary 搜索关键内容（见 miaoda-web-search skill） |
Common Mistakes
| 错误 | 正确做法 |
|---|---|
| 音频文件超过 10 分钟 | 拆分为更短的音频片段后分别转录 |
音频语言与 --lang 不匹配 |
确认音频实际语言，指定正确的语言代码 |
| 混合语言音频用单一语言代码 | 以主要语言为准，或按语言段落拆分音频 |
需要后续处理但未加 --output json |
需要程序处理转录结果时加 --output json |
| 命令失败后不检查 | 退出码 1 表示失败，检查文件路径和格式后重试 |