接口概览
SoulX API 接口能力、模型、错误码与价格概览
本文档涵盖以下内容：
- 模型列表：当前开放的模型清单，包括播客模型、对话模型。
- 接口简介：各能力的功能描述、特性与下属接口；接口包含音色管理、音色复刻、对话语音合成、播客语音合成等能力。
- 错误码查询：所有接口共享的状态码及含义、推荐处理方式。
- API 刊例价格：合成类接口（对话语音合成、播客语音合成）的原价与套餐折扣信息。
获取 API Key
通过 账户 -> 接口密钥 -> 创建新的 API Key 获取 API Key。
模型列表
| 类型 | 模型列表 |
|---|---|
| 播客模型 | soulx-tts-podcast-1.0 |
| 对话模型 | soulx-tts-chat-1.0 |
接口简介
音色管理
音色管理用于查询、维护当前账号下可用的音色资源（系统音色 + 复刻/克隆音色）。该能力支持以下功能：
- 同时查询系统音色与复刻音色，便于业务方选择合适的音色；
- 支持按音色类型筛选（仅系统、仅复刻、全部）；
- 支持删除指定的复刻/克隆音色（系统音色不支持删除）。
接口说明
音色管理共包含 2 个接口，可按需选择使用。
- 查询音色列表
- 删除音色
音色复刻
音色复刻用于基于用户提供的一段参考音频快速复刻出新的自定义音色，并支持复刻后立即试听。该能力支持以下功能：
- 支持基于上传音频（mp3 / wav / m4a）进行声音克隆；
- 支持复刻后立即合成一段试听音频，验证音色效果；
- 支持降噪、去混响、音量归一化等音频前处理开关；
- 支持自定义
voice_id命名（同账号下唯一）。
支持模型
| 模型 ID | 用途 |
|---|---|
soulx-tts-podcast-1.0 | 复刻后用播客模型试听 |
soulx-tts-chat-1.0 | 复刻后用对话模型试听 |
接口说明
音色复刻共包含 1 个接口。
- 音色复刻
对话式语音合成
对话语音合成用于对话场景的语音合成，单次可处理最长 10,000 字符 的文本，如果字数大于 3,000 字，推荐使用流式输出。该能力支持以下功能：
- 支持系统音色、复刻音色自主选择；
- 支持多种音频规格、格式，覆盖 pcm / mp3 / m4a / wav；
- 支持流式输出（流式仅支持 base64）；
- 支持上文
previous_context注入，让模型更贴合对话语境； - 支持字符级字幕（
enable_subtitle，仅非流式）。
支持模型
| 模型 ID | 说明 |
|---|---|
soulx-tts-chat-1.0 | 对话语音合成模型 |
接口说明
对话语音合成功能共包含 1 个接口。
- HTTP 同步语音合成
支持语言
- 中文
- 英文
播客语音合成
同步播客语音合成用于播客场景的语音合成，单次可处理最长 10,000 字符 的文本。该能力支持以下功能：
- 支持多说话人台本（
[speaker0]...[speaker1]...），每个说话人独立配置音色； - 支持系统音色、复刻音色自主选择；
- 支持多种音频规格、格式，覆盖 pcm / mp3 / m4a / wav；
- 支持句级别流式输出（流式尾包可附带整段完整音频与时长，
enable_complete_data=true）； - 支持字幕（仅流式）。
支持模型
| 模型 ID | 说明 |
|---|---|
soulx-tts-podcast-1.0 | 播客语音合成模型 |
接口说明
播客语音合成功能共包含 1 个接口。
- HTTP 同步播客语音合成
支持语言
- 中文
- 英文
错误码查询
所有接口共享同一套 base_resp.status_code 错误码：
| 错误码 | 含义 | 解决方案 |
|---|---|---|
| 1000 | 未知错误 | 稍后重试 |
| 1001 | 超时 | 稍后重试 / 设长超时时间 |
| 1002 | 触发限流 | 联系我们 |
| 1004 | 鉴权失败 | 检查 API Key |
| 1013 | 服务内部错误 | 稍后重试 |
| 1041 | 审核未通过 | 调整输入内容 |
| 1051 | 积分不足 | 检查账户余额 |
| 1052 | 复刻音色已达上限 | 检查音色数量 |
| 2013 | 输入参数错误 | 检查请求参数 |
| 2038 | 无复刻权限 | 请检查账号认证状态 |
精品音色
官方音色列表
| 音色ID | 音色名称 | 性别 | 年龄 | 音色描述 |
|---|---|---|---|---|
| Soulx_M_Y_ZH_Velvety-Mature_Podcast_k3R9 | 播音男声 | 男 | 18-30 | 沉稳理性的男声，适合多种场合 |
| Soulx_F_Y_ZH_Rough-Mature_Podcast_6pWq | 播音女声 | 女 | 18-30 | 知性沉稳的女声，适合多重场合 |
| Soulx_M_Y_ZH_Velvety-Soft_Podcast_oju2 | 磁性男声 | 男 | 18-30 | 磁性亲和的男声，适合深度谈话 |
| Soulx_F_Y_ZH_Sweet-Warm_Podcast_zby1 | 知性女声 | 女 | 18-30 | 优雅温柔的女声，适合情感与深度对谈 |
| Soulx_M_A_ZH_Rough-Mature_Podcast_84xb | 资深专家 | 男 | 30-50 | 资深权威的中年音，专业稳重 |
| Soulx_F_A_ZH_Rough-Mature_Podcast_b6gn | 博学专家 | 女 | 30-50 | 理性深入的中年音，适合专业解读 |
| Soulx_M_Y_ZH_Velvety-Lively_Podcast_I0n3 | 活力男声 | 男 | 18-30 | 充满活力的自然感男声，适合闲聊、自然对话 |
| Soulx_F_Y_ZH_Sweet-Lively_Podcast_H1h7 | 激情女声 | 女 | 18-30 | 澎湃激情的、充满活力的女声，适合自然对话类 |
| Soulx_M_Y_ZH_Velvety-Warm_Immersive_7upt | 故事男声 | 男 | 18-30 | 温柔细腻的男声，适合情感类故事 |
| Soulx_F_Y_ZH_Warm-Tender_Immersive_926i | 知心姐姐 | 女 | 18-30 | 温暖治愈的女声，适合情感治愈类话题 |
| Soulx_M_Y_ZH_Warm-Soft_Immersive_eo19 | 哄睡男声 | 男 | 18-30 | 舒缓助眠的男声，适合慢节奏、助眠类节目 |
| Soulx_F_Y_ZH_Mature-Soft_Immersive_7E1e | 哄睡女声 | 女 | 18-30 | 温馨轻柔，语调舒缓的女声，适合助眠冥想类音色。 |
| Soulx_M_Y_ZH_Neutral_Dialog_b43L | 生活男声 | 男 | 18-30 | 自然流畅、充满生活感的男声，适合自然对话类 |
| Soulx_F_Y_ZH_Neutral_Dialog_5P2n | 自然女声 | 女 | 18-30 | 口语化、充满生活感的女声，适合自然对话类 |
API 接口价格
针对合成接口：对话式语音合成、播客语音合成。
原价：¥3.4 / 万字符
| 分类 | 套餐一（节省约 10%） | 套餐二（节省约 15%） | 套餐三（节省约 20%） |
|---|---|---|---|
| 折扣价 | ¥610 | ¥5,800 | ¥54,000 |
| 原价 | ¥680 | ¥6,800 | ¥68,000 |
| 有效期 | 3 个月 | 6 个月 | 1 年 |
| 总字符数 | 2,000,000 字符 | 20,000,000 字符 | 200,000,000 字符 |
| 单价/万字符 | ¥3.05 | ¥2.9 | ¥2.7 |
如果订阅量超出上述套餐范围，可联系官方进行商务定制。
套餐权益、适用接口范围、并发能力、额度消耗规则和超额计费说明请联系官方沟通详情。
价格预估
选择字符数档位并填写购买数量，预估费用将自动计算。
字符数档位
预估费用
¥34
100,000 字符，有效期 1 个月
字符数统计标准：
1个汉字等于2字符，英文字母、希腊字母、标点符号、特殊符号、空格、回车等算1个字符；其中，同步播客语音合成接口请求时，输入文本中可能涉及的说话人标识（如[speaker0]）不计入字符数，副语言标签（如<|笑声|>，包括标签内文本）计为2个字符。