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 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：伺服器內部錯誤。
實際請求一個不存在的 ID 時上游會直接返回 400 Model not found（實測）：
返回：
錯誤響應示例：

​
結論

知道音色 _id 時直接用本介面拿完整 ModelEntity，最常見的用法是：(1) 試聽 samples[].audio，(2) 把 _id 餵給 /fish/tts 的 reference_id 完成合成。如果只有標題或標籤，請先用 Fish Model Query 檢索。