Skip to main content
本接口基于 Fish Audio 官方 Model API,用于基于一段音频样本创建一个新的克隆音色。地址为 POST https://api.acedata.cloud/fish/model
分页检索现有音色请参考 Fish Model Query API;按 _id 查询单个音色详情请参考 Fish Model Get API

申请流程

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

请求体字段

字段与上游完全一致,请同时参考 Fish 官方文档

示例:创建一个私有克隆音色

注意:voices 必须是字符串(单个音频 URL),不是数组。传成 ["..."] 上游会拒绝。
成功响应直接返回 Fish 平台的 ModelEntity 对象(下例为我们实测过的最小可用音色,删去了部分长字段以便阅读):
_id 即可作为后续 Fish TTS APIreference_id 字段的值,用于使用该克隆音色进行语音合成:

样本要求

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

计费说明

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

错误处理

  • 400 token_mismatched:请求参数缺失或不合法(最常见是 voices 不是 URL,或传成了数组)。
  • 401 invalid_token:鉴权 token 不存在或无效。
  • 429 too_many_requests:触发账号速率限制。
  • 500 api_error:服务器内部错误。
错误响应示例:

结论

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