POST https://api.acedata.cloud/fish/tts。
申请流程
要使用 Fish TTS API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。
如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。
一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：Fish TTS API →
请求头
请求体字段
一次性克隆只接受 HTTPS 音频 URL，不接受 MessagePack、Base64、data URI 或带凭据的 URL。参考音频建议 10–270 秒；Studio 使用更保守的 10–60 秒范围。
示例 1：最小请求（text + format=mp3）
audio_url 指向本平台 CDN，可直接 GET 下载或在 <audio> 中播放。最终成功响应还会返回顶层 cost，其中 amount 是本次实际扣除的 Credits；如有账户折扣，list_amount 表示折扣前额度。链接长期可用，但仍建议在你自己的存储里留一份。
示例 2：使用克隆音色 reference_id
下面用 Fish 平台上一个公开的西班牙语音色（_id 可通过 Fish Model Query 检索得到）：
示例 3：一次性即时声音克隆（references）
将参考音频放在公开 HTTPS 地址，并提供其中实际说出的准确原文。该声音只用于本次合成，不会创建长期模型：
示例 3：调节语速 / 音量（prosody）
speed 大于 1 加快，小于 1 减慢；volume 单位 dB，0 表示不变，正数增益，负数衰减。
示例 5：切换模型 + 控制码率
通过 HTTP 头model: s1 切换到稳定型模型，请求体中加 mp3_bitrate: 128 控制 MP3 码率：
示例 6：PCM 原始波形
需要在浏览器里做实时拼接、或在客户端做后续处理（混音、变速）的场景，推荐使用pcm：
链接的扩展名跟随请求里的format：mp3得到.mp3，wav与pcm得到.wav（WAV 容器，16 bit PCM）。
异步回调（callback_url）
长文本一次合成可能需要十几秒到几十秒，连接如果中断需要重试。请求体中传 callback_url 后，接口会立即返回 {task_id, started_at}，上游真正完成时把完整结果以 POST JSON 形式回调到该 URL，请求体中带同一个 task_id 和本次最终计费的顶层 cost。初始任务确认尚未完成合成，因此不包含 cost。
callback_url 会收到形如：
task_id 拉取结果；终态记录的 response.cost 与回调中的 cost 一致，详见该文档。
错误处理
400 token_mismatched：请求参数缺失或不合法（最常见是text为空，或format传了mp3/wav/pcm之外的值）。401 invalid_token：鉴权 token 不存在或无效。429 too_many_requests：触发账号速率限制。500 api_error：服务器内部错误。
message 字段说明不合法的字段，例如：
结论
接入 Fish TTS 的最小代价是：在已有调用api.fish.audio/v1/tts 的代码里把鉴权换成本平台 token，并在请求体里显式带上 format: "mp3"。长文本场景建议使用 callback_url 异步回调；对克隆音色 reference_id 的发现，请配合 Fish Model Query 与 Fish Model Get。