> ## Documentation Index
> Fetch the complete documentation index at: https://docs.senseaudio.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 常见问题

> SenseAudio 开放平台开发者常见问题解答

欢迎访问 SenseAudio 常见问题解答。我们整理了开发者在使用过程中最常遇到的问题。如果您的问题未在此列出，请通过 官方客服 或 **[senseaudio.support@sensetime.com](mailto:senseaudio.support@sensetime.com)** 联系我们的技术支持团队。

***

## 账号与鉴权

### 如何获取 API Key？

您可以在 **[SenseAudio API 平台](https://senseaudio.cn/api-platform/home)** 的 API 密钥页面创建和管理您的 API Key。

**重要提示**：

* API Key 是您调用接口的重要凭证，拥有该密钥即可消耗您的账户额度
* 请妥善保管，切勿将其提交到公开的代码仓库（如 GitHub）
* 不要在前端浏览器代码中直接暴露 API Key
* 建议定期轮换密钥以提高安全性

### API 调用返回 401 Unauthorized 错误

当您遇到 401 错误时，请按以下步骤排查：

1. **检查请求头格式**：确认请求头中包含正确的 Authorization 字段

   ```
   Authorization: Bearer $SENSEAUDIO_API_KEY
   ```

2. **验证 API Key 有效性**：
   * 检查 API Key 是否已过期
   * 确认 API Key 未被删除或禁用
   * 确保没有多余的空格或特殊字符

3. **检查账户状态**：确认您的账户余额充足且状态正常

### API Key 的权限范围是什么？

每个 API Key 具有以下权限：

* 调用所有已开放的 API 接口
* 访问您账户下的所有资源（音色、历史记录等）
* 消耗您的账户配额

如需更细粒度的权限控制，请联系我们的企业支持团队。

***

## 资源与配额

### 如何查看我的配额使用情况？

您可以在以下位置查看配额信息：

* **控制台首页**：显示当前余额和使用统计
* **调用日志**：查看详细的 API 调用记录和消耗明细
* **账单中心**：查看历史账单和消费趋势

### 如何获得更高的并发或调用额度？

SenseAudio 为不同规模的企业提供灵活的资源方案：

**标准方案**：适合中小规模应用

* 默认 QPS 限制
* 按量计费

**企业方案**：适合大规模生产环境

* 更高的 QPS 配额
* 专属技术支持
* 定制化 SLA 保障

如需升级，请联系商务团队：**[senseaudio.support@sensetime.com](mailto:senseaudio.support@sensetime.com)**

### 支持私有化部署吗？

支持。我们为对数据隐私有严格要求或需要内网部署的客户提供完整的私有化部署方案。

**私有化部署优势**：

* 数据完全本地化，满足合规要求
* 可定制化功能和性能配置
* 提供完整的技术支持和培训
* 支持离线环境运行

详情请通过邮件联系我们获取方案和报价。

***

## 功能使用

### 语音合成支持哪些语言？

目前支持以下语言：

* **中文**（普通话）
* **英语**
* **多语言混合**（如中英混读）

更多语言支持正在开发中，敬请期待。

### 如何选择合适的音色？

选择音色时可以考虑以下因素：

1. **应用场景**：客服、有声读物、广告配音等不同场景适合不同音色
2. **目标受众**：根据用户群体的年龄、性别、地域选择
3. **情感表达**：选择能够准确传达内容情感的音色
4. **试听对比**：在 **[系统音色列表](/guides/voice/catalog)** 中试听多个音色

### 生成的音频可以商用吗？

可以。您通过 SenseAudio API 生成的音频内容拥有完整的商业使用权，可用于：

* 商业广告
* 有声读物
* 视频配音
* 客服系统
* 其他合法商业用途

请确保您使用的文本内容本身不侵犯他人版权。

***

## 定制服务

### 如何定制专属的品牌音色？

我们提供专业级音色定制服务。

**服务内容**：

* **深度定制**：由专业录音师指导录制，打造广播级品质的专属音色
* **全风格适配**：根据品牌调性定制特定的情感、语速和风格
* **多语言支持**：支持中、英、日、韩等多语言混合定制
* **独占授权**：定制音色仅供您使用

**适用场景**：

* 企业品牌形象音色
* 虚拟主播/虚拟偶像
* 高端有声读物
* 品牌广告配音

如有需求，请发送邮件至 **[senseaudio.support@sensetime.com](mailto:senseaudio.support@sensetime.com)**。

***

## 技术支持

### 遇到技术问题如何反馈？

为了帮助我们更快地定位和解决问题，请在反馈时提供以下信息：

**必需信息**：

* **Request ID**：每次 API 调用返回的唯一标识符
* **错误信息**：完整的错误代码和错误描述
* **调用时间**：问题发生的具体时间（精确到分钟）

**建议提供**：

* 问题复现步骤
* 相关代码片段（请移除敏感信息）
* 请求和响应的完整内容
* 使用的编程语言和 SDK 版本

**联系方式**：

* 邮件：**[senseaudio.support@sensetime.com](mailto:senseaudio.support@sensetime.com)**
* 工单系统：登录控制台提交工单（企业用户）

### API 响应速度慢怎么办？

如果您遇到 API 响应缓慢的问题，可以尝试以下优化方法：

1. **使用流式输出**：对于长文本，使用 `stream: true` 参数可以更快获得首包响应
2. **选择合适的音频格式**：MP3 文件体积更小，下载传输更快；WAV 无损未压缩，编码更快
3. **检查网络环境**：确保您的服务器与 API 服务之间网络畅通
4. **分批处理**：将大量请求分批发送，避免瞬时高并发

如问题持续存在，请联系技术支持团队。

### 支持哪些开发语言和框架？

SenseAudio API 是标准的 RESTful API，支持所有能发起 HTTP 请求的编程语言，包括但不限于：

* **Python**（推荐使用 requests 库）
* **JavaScript/Node.js**（推荐使用 axios）
* **Go**
* **Java**
* **Swift**
* **PHP**
* **C#/.NET**
* **Ruby**

我们在文档中提供了主流语言的示例代码，您可以直接参考使用。