Fish 模型查询 API 集成指南

在本文中，我将带你手把手了解 Fish 模型查询 API（GET /fish/model）的使用方法。该接口与 Fish Audio 官方 OpenAPI 完全兼容，可用于 分页查询当前账号可见或全平台的克隆语音模型。

如果你想创建语音，请参考 Fish 模型创建 API；若只想查询单个语音模型详情，可使用 Fish 模型获取 API。

---

简介

Ace Data Cloud 是一个面向开发者的 AI 数据与模型服务平台，提供语音、文本、图像等多种 API 接口。通过 Fish 模型查询 API，你可以方便地管理自己的克隆语音库，快速检索所需语音模型，并将其应用于语音合成等场景，例如：

• 为智能客服或语音助手生成个性化语音
• 将音频内容克隆为指定声音风格
• 快速搭建语音生成服务

---

环境准备 / 前置条件

1. 拥有 Ace Data Cloud 账号：平台首页
2. 已申请 Fish 模型 API 服务：服务申请页
3. 获取 API 访问 Token（在“我的凭证”中申请）
4. 安装 curl 或任何支持 HTTP 请求的工具

---

详细步骤

1. 申请 API 使用权限

访问 Fish 模型 API 页面，点击 “获取” 按钮。

• 若未登录，系统会跳转至登录或注册页面
• 首次申请可获得免费额度，可免费使用本 API

---

2. 请求方式与认证

• 认证方式：Authorization: Bearer {token}
• 响应结构：直接返回 Fish 官方分页数据，如遇错误返回平台标准结构：

{
  "success": false,
  "error": {
    "code": "错误码",
    "message": "错误信息"
  },
  "trace_id": "追踪ID"
}

---

3. 请求示例

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'accept: application/json' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'page_size=10' \
  --data-urlencode 'page_number=1' \
  --data-urlencode 'self=true'

---

4. 支持的查询参数

参数	类型	说明
page_size	integer	每页数量，默认 10
page_number	integer	页码，从 1 开始
title	string	标题模糊搜索
tag	string	标签过滤
self	boolean	是否仅返回当前账号创建的语音
author_id	string	创建者过滤
language	string	语音语言过滤
title_language	string	标题语言过滤

---

5. 响应示例

成功响应会返回 Fish 官方分页数据：

{
  "items": [
    {
      "_id": "d7900c21663f485ab63ebdb7e5905036",
      "title": "My Clone Voice",
      "description": "A voice cloned from a podcast recording",
      "cover_image": "https://example.com/cover.png",
      "type": "tts",
      "state": "trained",
      "tags": [],
      "languages": ["zh", "en"],
      "visibility": "private",
      "created_at": "2025-05-09T12:34:56.789Z",
      "updated_at": "2025-05-09T12:34:56.789Z"
    }
  ],
  "total": 1
}

返回的 _id 可作为 Fish TTS API 的 reference_id，用于语音合成。

---

6. 计费说明

• 查询语音模型：免费
• 创建语音模型（POST /fish/model）且包含 voices 字段时才会计费

---

7. 错误处理

常见错误码示例：

错误码	含义
400 token_mismatched	请求参数缺失或无效
400 api_not_implemented	不支持的方法或参数
401 invalid_token	缺失或无效的认证信息
429 too_many_requests	超过当前账号速率限制
500 api_error	服务器内部错误

错误响应示例：

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

---

常见问题

1. 查询不到语音模型？

   • 检查 self 是否为 true
   • 检查 token 是否正确

2. 如何获取单个语音模型详细信息？

   • 使用 Fish 模型获取 API 并传入 _id

3. API 限速如何处理？

   • 避免频繁循环请求，可在客户端增加重试间隔

---

总结

Fish 模型查询 API 提供了 完整的语音模型检索能力，与 Fish Audio 官方 API 完全兼容。结合 Fish 模型获取 API，你可以快速构建自己的克隆语音库，并在语音合成、智能客服等场景中高效使用。

了解更多平台信息：Ace Data Cloud 官网、API 文档、身份认证

---

技术标签

#API集成 #语音合成 #AceDataCloud #FishAudio #开发教程