# AI 接入 Sonelle

Sonelle 将文字生成自然、有情绪的语音，提供网页创作与 API 接入。这里汇总产品能力、接入步骤和使用边界，供开发者与 AI 助手阅读。

## 快速开始

1. 在 [声音创作](https://www.sonelle.ai/experience/) 了解文字转语音的使用方式；预录试听不等于当前文本的生成结果。
2. 由账户所有者在 [我的账户](https://www.sonelle.ai/console/#keys) 创建 API Key，并在应用的服务端配置密钥。
3. 使用 `X-API-Key` 调用 `GET /api/v1/tts/voices`，从当前目录选择可用声线。
4. 按 [同步合成文档](https://www.sonelle.ai/docs/#sync) 调用 `POST /api/v1/text-to-speech`，取得完整音频。实际生成会使用账户额度。

## 产品能力

- **文字转语音**：输入文字、选择声线，生成可播放和下载的音频。适用于配音、故事朗读，以及应用中的语音表达。
- **情绪表达**：服务会根据文本分析表达风格；实际听感受文字和声线影响，请先试听确认。
- **动态声线目录**：声线 ID 与可用状态以接口响应为准，不应从网页维护一份固定清单。
- **完整音频响应**：当前同步接口在生成完成后一次返回音频；格式、文本长度和其他参数见 [接口说明](https://www.sonelle.ai/docs/#sync)。

Sonelle 在这里提供的是语音生成能力。实时双向通话、对话模型和声音克隆不属于当前公开接入能力。

## 认证与计费

声线目录和语音生成接口均使用 `X-API-Key` 认证。读取本页和公开文档不需要登录，也不需要密钥。

密钥应保存在应用服务端或客户端专用的凭据配置中，不要放入公开页面、源代码仓库或聊天提示词。AI 助手可以解释接口或编写接入代码；实际调用需由用户授权并配置凭据。

实际生成按账户配置计费，价格与可用额度请在 [我的账户](https://www.sonelle.ai/console/) 核对。本页不承诺免费生成，也不提供自动授权或自动充值。

## 请求与重试

同步请求中的 `request_id` 用于追踪请求，不提供生成或计费幂等保证。重复提交可能再次生成并计费。

遇到客户端超时、连接中断或 HTTP 504，不能仅凭未收到音频认定生成失败。请先核对业务状态和账户流水，再决定是否重新提交；不要让 AI 自动循环重试。限流处理见 [限流与重试](https://www.sonelle.ai/docs/#concurrency)。

本文的接入步骤使用同步接口。异步任务的使用条件和下载行为请单独阅读 [异步任务文档](https://www.sonelle.ai/docs/#async)，并在使用前确认服务可用性。

## MCP 与机器接口

目前尚未提供可连接的 Sonelle MCP 服务，也未发布 OpenAPI 描述文件。当前可通过现有 HTTP API 接入；不要把官网地址直接当作 MCP 服务器地址。

MCP 将作为后续能力，待身份授权、调用额度、任务恢复和音频访问机制完成验证后再提供连接说明。

## 官方资料

- [Sonelle 官网](https://www.sonelle.ai/)：产品介绍与声音试听。
- [开发文档](https://www.sonelle.ai/docs/)：认证、请求参数、音频格式与错误处理。
- [本文 Markdown](https://www.sonelle.ai/docs/ai/index.md)：与网页正文来自同一份源文件，便于文本读取。
- [AI 资料索引](https://www.sonelle.ai/llms.txt)：公开资料的简短导航。

网页主地址：https://www.sonelle.ai/docs/ai/ 。内容更新于 2026-09-26；运行中的声线目录和账户配置以实际响应为准。