Skip to main content
本接口基于 Fish Audio 官方 Model API,用于_id 查询单个克隆音色的完整详情。地址为 GET https://api.acedata.cloud/fish/model/{id}
创建音色请参考 Fish Model Create API;分页检索请参考 Fish Model Query API

申请流程

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

路径参数

无请求体、无查询参数。

示例:拉取一个公开西班牙语音色的完整详情

返回(实测,删去了 samples[].audio 中的签名 query string 以便阅读):
拿到的 _id 直接喂给 Fish TTSreference_id 即可合成相同音色的语音:

与列表接口的差异

如果只是要试听一下,列表接口里的 samples[].audio 已经够用;要更稳定的下载链接,建议改用本接口。

响应字段(节选)

计费说明

本接口不计费——按 ID 查询单个音色详情是免费操作。创建音色(Fish Model Create)同样免费,费用仅在调用 Fish TTS 合成语音时按用量产生。

错误处理

  • 400 token_mismatched:路径中的 id 不是合法格式,或上游报「Model not found」。
  • 401 invalid_token:鉴权 token 不存在或无效。
  • 404 not_found:指定 _id 在 Fish 上游不可见(音色被删除、私密、或属于其他账号)。
  • 429 too_many_requests:触发账号速率限制。
  • 500 api_error:服务器内部错误。
实际请求一个不存在的 ID 时上游会直接返回 400 Model not found(实测):
返回:
错误响应示例:

结论

知道音色 _id 时直接用本接口拿完整 ModelEntity,最常见的用法是:(1) 试听 samples[].audio,(2) 把 _id 喂给 /fish/ttsreference_id 完成合成。如果只有标题或标签,请先用 Fish Model Query 检索。