大多数智能体根本用不到这个功能。 每个智能体都可以使用我们音色库中的任意音色， 包括其中的 ElevenLabs 音色，不需要 ElevenLabs 账号，也不需要密钥：语音在我们的 账号上运行，和通话的其余部分一起按额度计费。这是我们推荐的做法，也是每个智能体 一开始的默认状态。
本指南只针对音色库覆盖不到的那一种情况：一个存在于 你自己的 ElevenLabs 账号里 的音色，比如你自己声音的克隆，或你在那里设计的音色。只有你的账号能用它说话，所以 我们需要你的 ElevenLabs 密钥才能使用它。你在 集成 中保存密钥，导入想要的音色， 再在智能体上选中其中一个。之后这部分语音由 ElevenLabs 向你的账号收费，我们不为它 扣任何额度。
一共三步，都在仪表板里完成：
- /integrations → 保存你的 ElevenLabs 密钥。
- 在这个集成上导入你的音色。
- /agents → 你的智能体 → 语音流水线 → 合成语音音色 → 在 您的音色 下选中它。
你需要准备什么
如果你只想用我们音色库中的音色，下面这些都不需要：在 合成语音音色 下选中它就 完成了。要使用你自己的音色，需要：
- 一个包含该音色的 ElevenLabs 账号：即时克隆或专业克隆、你设计的音色，或你已 添加到自己音色列表中的 Voice Library 音色。
- 一个带两项权限的 ElevenLabs API 密钥：Text to Speech 和 Voices: read。其他权限都不需要。在 ElevenLabs 的 API 密钥页面 （Settings → API Keys）创建一个，只勾选这两项，其余全部关闭。
- 工作区的所有者或管理员权限。只有所有者和管理员可以保存密钥和导入音色；之后， 任何能编辑智能体的人都可以为它选用已导入的音色。
- 一个使用 Standard (STT + LLM + TTS) 流水线的智能体。实时流水线自带音色， 不使用 ElevenLabs。
1. 保存密钥
/integrations → 添加集成 → 保存密钥 → ElevenLabs。 对话框的标题是 “保存 ElevenLabs 密钥”。粘贴密钥并保存。
保存之前，我们会先向 ElevenLabs 检查这个密钥：读取你的音色列表，并请 ElevenLabs 说出一个字符。这个字符会从你的 ElevenLabs 配额中扣除，也是这次检查唯一的花费。 没有 Text to Speech 权限的密钥无法通过检查，也不会被保存，因为它能读取你的 音色，却永远无法在通话中说话。
之后，这个密钥会以 ElevenLabs 的名称出现在 密钥 下，标签为 语音密钥。一个工作区同一时间只保存一个 ElevenLabs 密钥。要更换它，请在这个 集成上替换密钥，而不是再保存第二个。
密钥一旦保存，你的智能体使用的 每一个 ElevenLabs 音色都会通过它发声，包括我们 音色库里的 ElevenLabs 标准音色，而不仅仅是你导入的那些。整个工作区只有一条规则： 只要是 ElevenLabs 音色，就走你的密钥。如果你更希望音色库中的音色继续按额度计费， 就不要保存密钥；产品里没有其他功能需要它。
2. 导入你的音色
打开 ElevenLabs 集成。它的 概览 会列出 “你的 ElevenLabs 账号中的音色”：每个音色的名称、语言、类型 （克隆、生成、专业、ElevenLabs 默认），以及一个播放按钮，用来播放 ElevenLabs 为它保存的试听音频。没有试听音频的音色会显示 无试听；我们不会用 你的密钥去生成试听。
勾选你想要的音色，然后点击 导入所选。已导入的音色会移到 已导入的音色 下，并在列表中标记为 已导入。
不在列表里的音色，例如你可以使用、但还没有添加到自己账号里的 Voice Library 音色， 同样可以导入：在 “列表里没有？粘贴音色 ID” 下粘贴它的 ID，然后点击 导入。 如果 ElevenLabs 在你的密钥下不认识这个 ID，你会看到 “ElevenLabs 上这个密钥下没有 ID 为 … 的音色。“，并且不会导入任何内容。
列表最多显示 500 个音色。音色更多的账号会显示 “仅显示前 500 个音色。“；超出 部分的音色，粘贴它的 ID 即可。
3. 在智能体上选中它
/agents → 你的智能体 → 语音流水线 → 合成语音音色。音色选择器有一个 您的音色 筛选项，你导入的音色位于 音色库 上方，自成一个 您的音色 分区，每个都带有 您的密钥 标记。它们在每种语言视图里都会显示：克隆音色通常 能说多种语言，所以我们不会把它藏在它标注的那一种语言后面。
在你导入第一个音色之前，这个字段会带一条提示： “想使用您自己的克隆音色？从 ElevenLabs 导入”。选择器顶部的 添加您自己的音色 一行在导入之后也会一直保留。
你也可以直接告诉 Octo，例如 “把前台智能体换成我的 Lantern 音色”。它会把你导入 的音色和音色库一起列出来。
专业克隆。 ElevenLabs 会针对特定模型训练专业克隆。如果你的智能体所用的模型 不在其中，这个音色的那一行会显示 “运行于”，后面跟着它将使用的模型（例如 “运行于 Multilingual v2” ），通话会用那个模型来播放你的音色。在选择一个只能运行 于 Multilingual v2 的音色之前，请先阅读 ElevenLabs 语音模型： 它每次回答都会明显更晚开口。
然后给智能体打个电话。在把它放到号码上之前，智能体页面上的 试用语音 可以让你 直接在浏览器里和它对话。
费用
| 使用你的音色的通话中 | 谁付费 |
|---|---|
| 用你的音色说出的语音 | ElevenLabs 向 你的 账号收费。我们为它收取 0 额度。 |
| 电话线路、听取来电者的语音、AI 模型 | 照常计费，和任何通话一样。 |
| 备用音色说出的语音（见下文） | 照常计费：它运行在我们的 ElevenLabs 账号上，而不是你的。 |
密钥失效时
通话绝不会因为你的 ElevenLabs 账号而陷入沉默。如果 ElevenLabs 拒绝了你的密钥， 通话会改用我们 ElevenLabs 账号上的 备用音色 继续：一个与智能体语言相同的标准 音色；如果 ElevenLabs 标明了你的音色的性别，备用音色也会是同一性别。如果这发生在 一句回答的中途，那句回答会用备用音色从头再说一遍，所以来电者可能会听到几个字被 重复。
接下来会怎样，取决于 ElevenLabs 拒绝的原因：
- 密钥被撤销、删除，或失去了某项权限。 这通电话剩下的部分，以及之后的每一通 电话，都会从第一个字起就使用备用音色。集成上会显示 通话中失败，智能体的 音色字段会显示 “通话正在使用备用音色 …”。在 ElevenLabs 中修复密钥（或保存 一个新的），然后在集成上点击 检查密钥。检查通过后，下一通电话就会恢复成你的 音色。不会自动切换回来。
- 你的 ElevenLabs 配额用完了，或达到了同时通话数的上限。 通话会继续尝试使用你 的密钥，每当 ElevenLabs 拒绝时就切换到备用音色。一旦你的配额或套餐再次允许， 通话就会恢复成你的音色。
- 某个音色已从你的 ElevenLabs 账号中删除（或不再与你共享）。这个音色会显示 “已从你的 ElevenLabs 账号中删除”，之前使用它的通话会改用备用音色，而密钥本身 没有问题。重新导入它，或选择另一个音色。
当你的密钥或某个音色在通话中失败时，所有者会收到一封邮件，并抄送管理员：每种 失败每天最多一封，邮件中会列出受影响的智能体。与你的密钥无关的错误不会发邮件。 如果 ElevenLabs 在某一句回答上开口太慢，那句回答会用备用音色说出，下一句再重新 尝试你的密钥（连续两次开口太慢，这通电话剩下的部分就一直使用备用音色）。如果它以 其他原因不明的方式失败，比如服务器错误，这通电话剩下的部分会使用备用音色，下一通 电话再重新尝试你的密钥。
移除音色或密钥
已导入音色旁边的 移除 会把它从工作区中移除。如果还有智能体在使用它，你会看到 ”… 正在使用这个音色。请先为它们选择其他音色。“，并且不会移除任何内容。
删除 ElevenLabs 集成时，会先列出所有通过这个密钥说话的智能体，因为从那以后它们的 通话都会使用备用音色。集成的 使用方 一行也会统计这些智能体。
它不做什么
- 它不会克隆音色。音色由你在 ElevenLabs 中创建，我们负责使用。
- 它只支持 ElevenLabs。其他语音提供商的密钥无法以这种方式保存。
- 已导入的音色属于单个工作区。另一个工作区需要用它自己的密钥来导入。
- 它不会改变你的智能体回答的速度。决定速度的是语音模型，而不是它运行在谁的密钥上。