ASR 供应商配置¶
typeless-ibus 当前提供 13 个 provider 配置值，覆盖 10 个具名云端供应商和一个
OpenAI-compatible 通用入口。每个供应商的账号、凭据和可复制配置分别记录在独立文档中：
| 供应商 | provider |
配置说明 |
|---|---|---|
| 豆包输入法相关服务（默认） | doubao |
零配置、自动凭据与实现来源 |
| OpenAI-compatible 服务 | openai-compatible |
通用兼容接口 |
| OpenAI | whisper |
OpenAI 配置 |
| Groq | groq |
Groq 配置 |
| OpenRouter | openrouter |
OpenRouter 配置 |
| SiliconFlow（硅基流动） | siliconflow |
SiliconFlow 配置 |
| 智谱 AI | zhipu |
智谱配置 |
| ElevenLabs | elevenlabs |
ElevenLabs 配置 |
| 小米 MiMo | xiaomi-mimo-asr |
小米 MiMo 配置 |
| 阿里云百炼 | bailian、bailian-qwen3-realtime、bailian-fun-asr-flash |
百炼配置 |
| 火山引擎 | volcengine |
火山引擎配置 |
每个 provider 都提供“最小配置示例”和“最大配置示例”。除零配置的 doubao 外，最小
配置固定为 provider + apiKey；最大配置会列出该协议实现真正读取的全部可配置字段。
语种默认值¶
通常不需要在 JSON 中填写 language。引擎会参考系统 locale；如果系统是英文默认值但
时区位于中国，则优先使用中文。只有支持语言提示的 provider 才会收到该字段，不支持时
自动回退到模型检测。完整优先级、语言代码和 provider 能力见
语种选择与回退。
通用配置步骤¶
配置文件位于：
仓库里的 data/config.example.json 是可以直接使用的最小
配置。首次配置时可以在仓库根目录直接复制，再手动修改 provider；需要鉴权的供应商
只需按对应文档添加 apiKey：
endpoint、model、language、prompt 和 resourceId 都有内置默认或可省略行为，
无需预先写入。只有需要覆盖默认值时才参考供应商文档的最大配置添加。已有配置不要直接
覆盖，请原地编辑或先自行备份。这些默认值由 Rust provider 实现在运行时解析，不依赖
文档或示例 JSON。
供应商文档中的 JSON 只展示需要合并或替换的 asr 对象。请保留已有的
triggerKey、triggerMode、inputDevice 和 maxRecordingSeconds。修改后确保只有当前
用户可以读取配置：
切换到其他输入源再切回 Typeless IBus，让新引擎实例读取配置。然后先检查字段，再用一段 16 kHz、单声道、16-bit little-endian PCM 音频做真实识别：
/usr/libexec/typeless-ibus-engine --check-asr
/usr/libexec/typeless-ibus-engine \
--check-asr-audio /path/to/16k-mono-s16le.pcm
用户级安装请把命令路径换成 ~/.local/libexec/typeless-ibus-engine。--check-asr 对多数
供应商只验证本地字段，不会上传音频；能确认账号、模型与接口真正可用的是
--check-asr-audio。
凭据安全¶
apiKey 会以明文保存在本机配置文件中，但不会写入日志。
不要把真实配置提交到 Git，也不要把完整 Key 粘贴到 issue。遇到上游错误时可提供日志中的
请求 ID 或 x-tt-logid，无需提供密钥。