_id 查询单个克隆音色的完整详情。地址为 GET https://api.xhuoapi.ai/v1/fish/model/{id}。
创建音色请参考 Fish Model Create API;分页检索请参考 Fish Model Query API。
申请流程
要使用 API,需要先到 Fish Model API 对应页面申请对应的服务,进入页面之后,点击「Acquire」按钮。 如果你尚未登录或注册,会自动跳转到登录页面邀请您来注册和登录,登录注册之后会自动返回当前页面。 在首次申请时会有免费额度赠送,可以免费使用该 API。路径参数
无请求体、无查询参数。
示例:拉取一个公开西班牙语音色的完整详情
samples[].audio 中的签名 query string 以便阅读):
_id 直接喂给 Fish TTS 的 reference_id 即可合成相同音色的语音:
与列表接口的差异
如果只是要试听一下,列表接口里的
samples[].audio 已经够用;要更稳定的下载链接,建议改用本接口。
响应字段(节选)
计费说明
本接口不计费——按 ID 查询单个音色详情是免费操作,仅 Fish Model Create 在请求体携带voices 字段创建新音色时计费。
错误处理
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 检索。
