Fish Model Query API интеграция

Этот интерфейс основан на Fish Audio официальном Model API и предназначен для постраничного поиска в публичной библиотеке звуковых моделей Fish или клонированных звуковых моделей текущего аккаунта. Адрес: GET https://api.acedata.cloud/fish/model.

Для создания звуковой модели смотрите Fish Model Create API; для запроса деталей одной звуковой модели по _id смотрите Fish Model Get API.

Процесс запроса

Чтобы использовать Fish Model API, сначала получите ваш API Token в консоли Ace Data Cloud и сохраните его для использования.

Если вы еще не вошли в систему или не зарегистрированы, вы будете автоматически перенаправлены на страницу входа, где вам будет предложено зарегистрироваться и войти. После завершения вы будете автоматически возвращены на текущую страницу. Один API Token позволяет использовать все сервисы платформы, не нужно запрашивать отдельный токен для каждого сервиса. При первом запросе предоставляется бесплатный лимит, чтобы вы могли попробовать; если лимит исчерпан, вы можете пополнить общий баланс в консоли.

📘 Полная документация: Fish Model API →

Параметры запроса

Параметр	Тип	По умолчанию	Описание
`page_size`	integer	10	Количество элементов на странице.
`page_number`	integer	1	Номер страницы, начиная с 1.
`title`	string	—	Поиск по заголовку с нечетким совпадением.
`tag`	string	—	Фильтрация по одному тегу.
`self`	boolean	—	Если `true`, возвращает только звуковые модели, созданные текущим аккаунтом, без дополнительных условий.
`author_id`	string	—	Фильтрация по `_id` пользователя.
`language`	string	—	Фильтрация по языку звуковой модели, например, `en`, `zh`, `es`.
`title_language`	string	—	Фильтрация по языку заголовка.
`sort_by`	string	—	Поле сортировки, совпадающее с upstream, например, `created_at`, `task_count`.

Имена параметров полностью совпадают с upstream GET https://api.fish.audio/model, подробности смотрите в официальной документации Fish.

Пример 1: Стандартная постраничная навигация (по `page_size`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'page_size=2'

Ответ (на практике, общее количество в публичной библиотеке около 1,8 миллиона; для читаемости в примере опущены некоторые длинные поля):

{
  "total": 1829200,
  "items": [
    {
      "_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
      "type": "tts",
      "title": "Valentino Narración Biblica Fer",
      "description": "Зрелый и авторитетный мужской голос с спокойным, духовным тоном...",
      "cover_image": "coverimage/8d2c17a9b26d4d83888ea67a1ee565b2",
      "train_mode": "fast",
      "state": "trained",
      "tags": ["male", "old", "narration", "calm", "Spanish"],
      "samples": [
        {
          "title": "Default Sample",
          "text": "Hermanos míos, recordemos las palabras del Señor...",
          "task_id": "59ce7df6935c42249759327ddf70f37b",
          "audio": "https://platform.r2.fish.audio/task/59ce7df6935c42249759327ddf70f37b.mp3"
        }
      ],
      "languages": ["es"],
      "visibility": "public",
      "like_count": 4344,
      "task_count": 708461,
      "author": {
        "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
        "nickname": "Fernando Caicedo"
      }
    },
    {
      "_id": "90e65eaaf50e4470b8e6d43ee6afd7d5",
      "type": "tts",
      "title": "Super Smash Bros. 4/Ultimate Announcer",
      "tags": ["male", "old", "announcer", "gaming", "cinematic"],
      "languages": ["en"],
      "visibility": "public"
    }
  ],
  "has_more": null
}

Пример 2: Поиск по заголовку с нечетким совпадением (`title`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'title=narration' \
  --data-urlencode 'page_size=2'

Ответ (на практике):

{
  "total": 161,
  "items": [
    {
      "_id": "fb8fe4a94658429d9be70efd4eec35a2",
      "type": "tts",
      "title": "Miles Morales ( Narration Paw )",
      "tags": ["male", "middle-aged", "entertainment", "storytelling", "Children's Content"],
      "languages": ["en"],
      "visibility": "public",
      "task_count": 770
    },
    {
      "_id": "76b55591c758444cb95253708696dfad",
      "type": "tts",
      "title": "Joe NARRATION",
      "tags": ["male", "middle-aged", "narration", "deep", "raspy"],
      "languages": ["en"],
      "visibility": "public"
    }
  ],
  "has_more": null
}

Обратите внимание, что title является «глобальным нечетким совпадением», которое будет совпадать со всеми звуковыми моделями в публичной библиотеке Fish (не только с вашими).

Пример 3: Только свои созданные звуковые модели (`self=true`)

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'self=true' \
  --data-urlencode 'page_size=5'

Ответ (на практике, в текущем аккаунте только 1 звуковая модель):

{
  "total": 1,
  "items": [
    {
      "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
      "type": "tts",
      "title": "copilot-smoke-test",
      "description": "smoke test from api.acedata.cloud",
      "state": "trained",
      "languages": ["zh"],
      "visibility": "public",
      "samples": [
        {
          "title": "Default Sample",
          "text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
          "task_id": "6a1bf398dfae49dca0e23159214342a0",
          "audio": "https://platform.r2.fish.audio/task/6a1bf398dfae49dca0e23159214342a0.mp3"
        }
      ],
      "created_at": "2026-05-10T03:52:55.601000Z",
      "author": {
        "_id": "780f2b2f862d41a08c0507bbbda77eb6",
        "nickname": "Penny Conrad"
      }
    }
  ],
  "has_more": null
}

self=true эквивалентно фильтрации по author_id == текущий ID пользователя, что является распространенным способом получения «списка моих звуковых моделей».

Пример 4: Фильтрация по языку + тегам

curl -G 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  --data-urlencode 'language=zh' \
  --data-urlencode 'tag=narration' \
  --data-urlencode 'page_size=5'

Вверх по потоку также будет возвращать результаты для tag, не находящихся в словаре тегов, но соответствие будет относительно широким; если количество совпадений равно 0, рекомендуется использовать нечеткое соответствие по title.

Поля ответа

Каждый элемент в items[] является полным объектом ModelEntity, часто используемые поля:

Поле	Тип	Описание
`_id`	string	ID голоса, используется как значение `reference_id` в `/fish/tts`.
`type`	string	Тип модели, обычно `tts`.
`title`	string	Название голоса.
`description`	string	Описание голоса.
`state`	string	Состояние обучения: `trained` означает доступно.
`tags`	string[]	Теги публичной библиотеки.
`languages`	string[]	Языки, в которых голос преуспевает.
`visibility`	string	`public` или `private`.
`samples`	object[]	Предустановленные образцы (включая прямые ссылки на `audio`).
`like_count`	integer	Количество лайков в публичной библиотеке.
`task_count`	integer	Историческое количество синтезов.
`author`	object	Информация об авторе вверх по потоку: `_id` / `nickname` / `avatar`.
`total` (верхний уровень)	integer	Общее количество, соответствующее условиям.
`has_more`	boolean?	Указатель на пагинацию вверх по потоку, может быть `null`. Рекомендуется использовать `total / page_size` для расчета общего количества страниц.

Условия оплаты

Этот интерфейс не облагается платой — пагинация запроса списка голосов является бесплатной операцией. Создание голоса (Fish Model Create) также бесплатно, плата взимается только при вызове Fish TTS для синтеза речи по мере использования.

Обработка ошибок

400 token_mismatched: отсутствуют или недействительны параметры запроса.
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"
}

Заключение

Чтобы выбрать голос из публичной библиотеки Fish для передачи в reference_id /fish/tts, сначала используйте этот интерфейс в сочетании с title / tag / language для поиска, чтобы определить целевой _id, затем используйте Fish Model Get для получения образцов для прослушивания. Чтобы перечислить созданные вами голоса, передайте self=true.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Coding

Fish Model Query API интеграция

Процесс запроса

Параметры запроса

Пример 1: Стандартная постраничная навигация (по `page_size`)

Пример 2: Поиск по заголовку с нечетким совпадением (`title`)

Пример 3: Только свои созданные звуковые модели (`self=true`)

Пример 4: Фильтрация по языку + тегам

Поля ответа

Условия оплаты

Обработка ошибок

Заключение

​Процесс запроса

​Параметры запроса

​Пример 1: Стандартная постраничная навигация (по page_size)

​Пример 2: Поиск по заголовку с нечетким совпадением (title)

​Пример 3: Только свои созданные звуковые модели (self=true)

​Пример 4: Фильтрация по языку + тегам

​Поля ответа

​Условия оплаты

​Обработка ошибок

​Заключение

Процесс запроса

Параметры запроса

Пример 1: Стандартная постраничная навигация (по `page_size`)

Пример 2: Поиск по заголовку с нечетким совпадением (`title`)

Пример 3: Только свои созданные звуковые модели (`self=true`)

Пример 4: Фильтрация по языку + тегам

Поля ответа

Условия оплаты

Обработка ошибок

Заключение