Use when user needs to convert audio or voice recordings to text. Provides necessary command usage instructions for converting audio to text. Supports multiple languages. 触发词：语音转文字, 音频转文字, 语音识别, speech to text, STT, 转录, 听写, 会议记录转文字, 录音转文字, transcribe, 音频识别, voice to text, 语音转换
通过 miaoda-studio-cli speech-to-text 将音频文件转换为文字。
| 参数 | 说明 | 必需 | 默认值 |
|---|---|---|---|
--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） |
| 错误 | 正确做法 |
|---|---|
| 音频文件超过 10 分钟 | 拆分为更短的音频片段后分别转录 |
音频语言与 --lang 不匹配 | 确认音频实际语言，指定正确的语言代码 |
| 混合语言音频用单一语言代码 | 以主要语言为准，或按语言段落拆分音频 |
需要后续处理但未加 --output json | 需要程序处理转录结果时加 --output json |
| 命令失败后不检查 | 退出码 1 表示失败，检查文件路径和格式后重试 |