跳转到主要内容
本接口基于 Fish Audio 官方 Model API，用于基于一段音频样本创建一个可长期复用的克隆声音模型。地址为 POST https://api.acedata.cloud/fish/model。
只需临时使用参考声音时，无需创建模型，可直接使用 Fish TTS API 的 references 一次性即时克隆。分页检索现有音色请参考 Fish Model Query API；按 _id 查询单个音色详情请参考 Fish Model Get API。

​
申请流程

要使用 Fish Model API，首先到 Ace Data Cloud 控制台 获取您的 API Token，留作备用。 如果你尚未登录或注册，会自动跳转到登录页面邀请你注册和登录，完成后会自动返回当前页面。 一个 API Token 即可调用平台所有服务，无需为每个服务单独申请。 首次申请会赠送免费额度，可免费体验；额度不足时可在 控制台 充值通用余额。
📘 完整文档：Fish Model API →

​
请求体字段

音色模型的更多信息可参考 Fish 官方文档。
创建的音色会长期公开保存，其他用户可能搜索并使用。无需传 visibility；即使传入 private 或 unlist，当前接口也不会据此改变公开范围。

​
示例：创建一个公开克隆音色

注意：voices 必须是字符串（单个音频 URL），不是数组。传成 ["..."] 上游会拒绝。建议使用带 .mp3 或 .wav 后缀、可公开下载的直链。
成功响应直接返回 Fish 平台的 ModelEntity 对象（下例为我们实测过的最小可用音色，删去了部分长字段以便阅读）：
_id 即可作为后续 Fish TTS API 中 reference_id 字段的值，用于使用该克隆音色进行语音合成： 创建成功的音色会公开保存，可通过 Fish Model Query API 的 self=true 查询当前调用用户通过本平台创建的音色。self=true 只筛选列表，不限制其他用户使用该音色。

​
样本要求

经验值（与上游一致，可参考 Fish 官方文档）：
  • 时长建议 30 秒以上，5 分钟以内效果最佳；超过 10 分钟边际收益不大。
  • 采样率 16 kHz 及以上，单声道或立体声均可。
  • 内容尽量干净：无背景音乐、回声、明显环境噪声；同一说话人。
  • 格式建议 mp3 / wav。
如果对样本质量没有把握，可以同时传 enhance_audio_quality: true 让上游先做音质增强。

​
计费说明

创建音色克隆模型（POST /fish/model）免费，不收取任何费用；音色的查询接口（Fish Model Query、Fish Model Get）同样不计费。费用仅在后续调用 Fish TTS 合成语音时按用量产生。

​
错误处理

  • 400 token_mismatched：请求参数缺失或不合法（最常见是 voices 不是 URL，或传成了数组）。
  • 400：参考音频无法下载、时长过短或格式无法识别时，请检查音频 URL 和文件格式。
  • 401 invalid_token：鉴权 token 不存在或无效。
  • 429 too_many_requests：触发账号速率限制。
  • 500 api_error：服务器内部错误。
错误响应示例：

​
结论

调用本接口只需要准备一段可公开访问的样本音频 URL，把它放到 voices 字段即可拿到 _id，再喂给 /fish/tts 的 reference_id 就完成了端到端的「克隆 → 合成」。常见坑点是 voices 必须是字符串、不能是数组。

​
通过 MCP 创建并复用音色

在 Fish MCP 中调用 fish_create_model(title="我的音色", voices="https://example.com/authorized-voice.wav")。 voices 是单个 HTTP(S) 音频 URL；还可传 description、cover_image、tags、 texts、enhance_audio_quality、generate_sample。 该工具会长期保存公开音色，其他用户可能发现并使用；请仅使用获准处理和公开的 音频素材。工具没有私有或不公开选项。创建成功返回的 _id 用于 fish_generate_audio 的 reference_id，fish_list_models(self=true) 可查询自己 保存的音色。只需要一次性参考声音时，使用 fish_generate_audio 的 references， 无需创建长期音色。