_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 TTS 的 reference_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:服务器内部错误。
400 Model not found(实测):
结论
知道音色_id 时直接用本接口拿完整 ModelEntity,最常见的用法是:(1) 试听 samples[].audio,(2) 把 _id 喂给 /fish/tts 的 reference_id 完成合成。如果只有标题或标签,请先用 Fish Model Query 检索。
