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 表示失败，检查文件路径和格式后重试 |