静觅
·
Fish TTS API 对接说明
内容提要
Fish TTS API 是基于 Fish Audio 官方 TTS API 的接口，使用时需申请 API Token。请求格式为 POST，支持文本合成和音频格式选择（mp3 或 pcm）。可通过异步回调获取长文本合成结果，错误处理包括鉴权失败和参数错误。
关键要点
-
Fish TTS API 基于 Fish Audio 官方 TTS API，使用时需申请 API Token。
-
请求格式为 POST，支持文本合成和音频格式选择（mp3 或 pcm）。
-
可通过异步回调获取长文本合成结果，连接中断时需重试。
-
错误处理包括鉴权失败（401）、参数错误（400）和速率限制（429）。
-
请求体字段包括 text、format、reference_id、prosody 等，具体字段含义与上游一致。
-
首次申请 API Token 会赠送免费额度，额度不足时可在控制台充值。
延伸解读
API Token 申请与使用
使用 Fish TTS API 前，用户需在 Ace Data Cloud 控制台申请 API Token。首次申请会获得免费额度，便于用户体验服务。值得注意的是，申请的 Token 可用于调用平台的所有服务，无需为每个服务单独申请，这降低了使用门槛。
请求格式与参数设置
Fish TTS API 的请求格式为 POST，支持文本合成和音频格式选择。用户需明确指定音频格式（mp3 或 pcm），并根据需求设置其他参数，如语速和音量。合理配置这些参数可以显著提升合成音频的质量和适用性。
错误处理与调试
在使用 Fish TTS API 时，可能会遇到鉴权失败、参数错误等问题。了解常见错误代码（如401、400、429）及其含义，有助于快速定位问题并进行调试。此外，错误响应中会提供详细信息，便于开发者进行修正。
延伸问答
如何申请 Fish TTS API 的 API Token？
要申请 Fish TTS API 的 API Token，首先需要登录或注册 Ace Data Cloud 控制台，完成后会自动返回当前页面以获取 Token。
Fish TTS API 支持哪些音频格式？
Fish TTS API 支持的音频格式包括 mp3 和 pcm。
如何处理 Fish TTS API 的错误？
Fish TTS API 的错误处理包括鉴权失败（401）、参数错误（400）和速率限制（429），需要根据错误代码进行相应处理。
Fish TTS API 的请求格式是什么？
Fish TTS API 的请求格式为 POST，必须包含请求头和请求体，具体字段包括 text、format 等。
如何使用异步回调获取长文本合成结果？
可以在请求体中传入 callback_url，接口会立即返回 task_id，合成完成后会通过该 URL 回调结果。
首次申请 Fish TTS API Token 是否有免费额度？
首次申请 Fish TTS API Token 会赠送免费额度，可以免费体验服务。
