AI 接入 Sonelle

快速开始

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

产品能力

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

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

认证与计费

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

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

实际生成按账户配置计费，价格与可用额度请在 我的账户 核对。本页不承诺免费生成，也不提供自动授权或自动充值。

请求与重试

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

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

本文的接入步骤使用同步接口。异步任务的使用条件和下载行为请单独阅读 异步任务文档，并在使用前确认服务可用性。

MCP 与机器接口

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

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

官方资料

• Sonelle 官网：产品介绍与声音试听。
• 开发文档：认证、请求参数、音频格式与错误处理。
• 本文 Markdown：与网页正文来自同一份源文件，便于文本读取。
• AI 资料索引：公开资料的简短导航。

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