> For the complete documentation index, see [llms.txt](https://docs.convai.com/api-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/speech-recognition-language-support.md).

# 语音识别语言支持

参考 Convai 如何根据角色语言选择语音识别提供商，包括各提供商覆盖范围以及多语言行为。

Convai 使用四种语音识别服务商之一转录玩家语音。您无法直接选择服务商；系统会根据您在 **核心 AI 设置**中设置的语言来确定服务商。本页介绍各服务商支持的语言、尝试顺序，以及角色设置了多种语言时会发生什么。

### Convai 如何选择服务商

Convai 会按固定顺序尝试各服务商，并在遇到第一个支持角色所有语言的服务商时停止。顺序优先考虑延迟最低的服务商，并以语言覆盖范围作为次要判断标准，因此角色通常会使用能够处理其语言的最快服务商。

| 角色设置的语言数 | 尝试顺序                                          |
| -------- | --------------------------------------------- |
| 恰好一种     | Soniox、Deepgram Nova-3、Deepgram Nova-2、Google |
| 两种或更多    | Soniox、Google                                 |

如果服务商不支持所选语言中的某一种，系统会自动跳过它，并尝试该行中的下一家服务商。如果 Soniox 不可用，设置为单一语言的角色会转而使用 Deepgram Nova-3；设置为两种或更多语言的角色则会转而使用 Google，因为 Deepgram 根本不在该行的候选服务商之列。

由于系统只依据所选语言做出这一选择，因此您选择的语言会决定转录质量。如果角色仍使用默认的英语设置，而用户讲的是其他语言，语音就会被转录为英语。

语言列表和 **仅使用所选语言回复** 设置位于 **核心 AI 设置**中。该设置控制角色的回复，不会改变负责转录用户语音的服务商；两者都在同一个语言列表中配置。

### 各服务商的语言覆盖范围

数量统计的是不同的基础语言；第二列将地区变体单独计数。

| 服务商             | 基础语言 | 地区变体      |
| --------------- | ---- | --------- |
| Google          | 75   | 136 个区域代码 |
| Soniox          | 60   | 仅基础语言代码   |
| Deepgram Nova-3 | 50   | 107 个区域代码 |
| Deepgram Nova-2 | 33   | 70 个区域代码  |

四家服务商共支持 78 种不同的基础语言，其中 33 种语言受到所有服务商支持。

### Soniox 不支持的语言

Soniox 会优先尝试，但无法处理以下 19 种基础语言。对于这些语言，只有 Google 提供支持，因此使用其中一种语言的角色会由 Google 提供服务。

| 语言    | 代码    | 语言    | 代码   |
| ----- | ----- | ----- | ---- |
| 阿姆哈拉语 | `am`  | 蒙古语   | `mn` |
| 亚美尼亚语 | `hy`  | 尼泊尔语  | `ne` |
| 缅甸语   | `my`  | 普什图语  | `ps` |
| 粤语    | `yue` | 僧伽罗语  | `si` |
| 菲律宾语  | `fil` | 巽他语   | `su` |
| 格鲁吉亚语 | `ka`  | 乌兹别克语 | `uz` |
| 冰岛语   | `is`  | 祖鲁语   | `zu` |
| 爪哇语   | `jv`  | 旁遮普语  | `pa` |
| 高棉语   | `km`  |       |      |
| 老挝语   | `lo`  |       |      |
| 马耳他语  | `mt`  |       |      |

### 选择多种语言

如语言字段本身所述，一个角色最多可以设置四种语言。添加第二种语言会在两个方面改变行为。

候选列表会缩减为 Soniox 和 Google，因此不再使用 Deepgram。

Soniox 也会改变处理所选语言的方式，但规则取决于不同语言的种类数，而不是你选择了多少个条目。同一种语言的地区变体会合并计算：同时选择西班牙语（西班牙）和西班牙语（墨西哥），对 Soniox 来说仍然只算一种语言，因此识别仍限定为西班牙语。只有在所选语言包含两种真正不同的语言时，识别才会将它们视为提示。

{% hint style="warning" %}
选择了两种不同的语言后，语音识别可能会返回你未选择的语言。请只选择角色确实需要的语言。
{% endhint %}

在这种模式下，Google 支持的语言范围最广；选择多种语言时，它支持全部 75 种基础语言。

### 没有提供商支持所选语言时

如果没有任何可用提供商支持所有选定的语言，角色不会改用无法理解其用户语言的提供商。会话将无法启动，因为连接成功但语音输入不可用，比无法连接更难排查。

{% hint style="info" %}
可供选择的语言取决于你的账户，其中可能包含私有语言。使用 Language List API 获取你可用语言的准确列表。
{% endhint %}

### 相关参考

{% content-ref url="/pages/82227f72ca96afab32d1b36eb1030f723fc92d40" %}
[语言与语音](https://docs.convai.com/api-docs/zh/convai-playground/character-customization/language-and-speech.md)
{% endcontent-ref %}

{% content-ref url="/pages/fdfed88f59c6997bd47c6e08c93781d8de8d9d7d" %}
[语言列表 API](https://docs.convai.com/api-docs/zh/api-can-kao/core-api-reference/character-crafting-apis/language-list-api.md)
{% endcontent-ref %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.convai.com/api-docs/zh/convai-playground/character-customization/speech-recognition-language-support.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
