阿里云百炼 ASR¶

文档首页 · ASR 供应商 · 阿里云百炼

同一个阿里云百炼 API Key 可以配置 typeless-ibus 的三种协议。它们的延迟、模型与可选字段 不同，请只选择一个 provider：

获取 API Key、地域与 Workspace¶

1. 登录 阿里云百炼控制台。
2. 在右上角先选择要调用模型的地域。API Key、API Host、Workspace 和地域必须一致。
3. 打开 API Key 页面，单击“创建 API Key”。建议使用默认业务空间；需要限制时再配置 可访问模型和公网 IP 白名单。
4. 创建后立即复制弹窗里的完整 API Key 和 API Host。新版 sk-ws Key 的明文只显示 一次；丢失后需要重置或重新创建。
5. 使用子业务空间或控制台给出 workspace 专属域名时，同时在业务空间页面复制 Workspace ID。

官方入口：获取 API Key · 语音识别模型选择

方案一：Fun-ASR 经典实时¶

最小配置示例¶

{
  "asr": {
    "provider": "bailian",
    "apiKey": "replace-with-bailian-api-key"
  }
}

最大配置示例¶

显式列出 endpoint 与 model：

{
  "asr": {
    "provider": "bailian",
    "endpoint": "wss://dashscope.aliyuncs.com/api-ws/v1/inference/",
    "apiKey": "replace-with-bailian-api-key",
    "model": "fun-asr-realtime"
  }
}

通常使用内置默认值即可。只有控制台为当前地域或 Workspace 给出不同地址或模型 ID 时才 覆盖。

方案二：Qwen3 ASR Realtime¶

最小配置示例¶

{
  "asr": {
    "provider": "bailian-qwen3-realtime",
    "apiKey": "replace-with-bailian-api-key"
  }
}

最大配置示例¶

使用当前 workspace 专属域名时，可以显式填写全部支持字段，例如北京地域：

{
  "asr": {
    "provider": "bailian-qwen3-realtime",
    "endpoint": "wss://replace-with-workspace-id.cn-beijing.maas.aliyuncs.com/api-ws/v1/realtime",
    "apiKey": "replace-with-bailian-api-key",
    "model": "qwen3-asr-flash-realtime",
    "language": "zh"
  }
}

省略 language 时，引擎会在系统推断值属于 Qwen3 ASR 官方支持列表时发送；其他语种省略 该字段并由模型自动判断。默认 endpoint 是 wss://dashscope.aliyuncs.com/api-ws/v1/realtime，默认 model 是 qwen3-asr-flash-realtime。

新加坡等地域的域名不同，请从官方 Qwen-ASR Realtime 交互流程 复制，不要只替换地域字符串。

方案三：Fun-ASR-Flash 批量识别¶

最小配置示例¶

{
  "asr": {
    "provider": "bailian-fun-asr-flash",
    "apiKey": "replace-with-bailian-api-key"
  }
}

最大配置示例¶

{
  "asr": {
    "provider": "bailian-fun-asr-flash",
    "endpoint": "https://dashscope.aliyuncs.com/api/v1/services/aigc/multimodal-generation/generation",
    "apiKey": "replace-with-bailian-api-key",
    "model": "fun-asr-flash-2026-06-15"
  }
}

默认 endpoint 使用中国大陆 DashScope multimodal-generation 地址。若创建 Key 时显示的 API Host 不同，请按同一地域的模型文档拼出完整 HTTP endpoint。typeless-ibus 会把超过 180 秒的录音切片后提交。

验证¶

无论选择哪种方案，都先运行：

/usr/libexec/typeless-ibus-engine --check-asr
/usr/libexec/typeless-ibus-engine \
  --check-asr-audio /path/to/16k-mono-s16le.pcm

401/403 时依次核对 Key 是否完整、Key 所属地域、Workspace 的模型权限和 IP 白名单。 404 或 WebSocket 握手失败时，重点核对当前协议的完整 endpoint；不要把 OpenAI-compatible 文本 Base URL 填到三个 ASR provider 中。

返回供应商索引