Fish Model Get API інтеграційна інструкція

Цей інтерфейс базується на 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 →

Параметри шляху

Параметр	Обов’язковий	Опис
`id`	Так	`_id` голосу (32-значний шістнадцятковий рядок). Можна отримати під час створення через Fish Model Create або через Fish Model Query.

Без тіла запиту, без параметрів запиту.

Приклад: отримання повних деталей публічного іспанського голосу

curl 'https://api.acedata.cloud/fish/model/8d2c17a9b26d4d83888ea67a1ee565b2' \
  -H 'authorization: Bearer {token}'

Відповідь (на основі тестування, підписаний рядок запиту в samples[].audio видалено для зручності читання):

{
  "_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", "serious",
    "authoritative", "professional", "clear", "Spanish"
  ],
  "samples": [
    {
      "title": "Default Sample",
      "text": "Hermanos míos, recordemos las palabras del Señor en estos tiempos difíciles. Como dice la Escritura, la fe mueve montañas, y el amor de Dios nos guía en cada paso del camino. Mantengamos firme nuestra confianza en Su divina providencia.",
      "task_id": "59ce7df6935c42249759327ddf70f37b",
      "audio": "https://c97f3361a1c971323738e24f451a0225.r2.cloudflarestorage.com/fish-platform-data/task/59ce7df6935c42249759327ddf70f37b.mp3?X-Amz-...signed..."
    }
  ],
  "created_at": "2025-03-13T08:11:10.326000Z",
  "updated_at": "2026-05-03T09:01:41.437000Z",
  "languages": ["es"],
  "visibility": "public",
  "lock_visibility": false,
  "dmca_taken_down": false,
  "default_text": "Hermanos míos, recordemos las palabras del Señor...",
  "quality": null,
  "like_count": 4344,
  "mark_count": 4409,
  "shared_count": 590,
  "task_count": 708461,
  "unliked": false,
  "liked": false,
  "marked": false,
  "author": {
    "_id": "1b82fb6a329c4462b67aa9ee0a42046f",
    "nickname": "Fernando Caicedo",
    "avatar": "avatars/1b82fb6a329c4462b67aa9ee0a42046f.jpg"
  }
}

Отриманий _id просто передайте в reference_id Fish TTS для синтезу голосу з таким же тембром:

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "Hermanos míos, hoy es un buen día.",
    "reference_id": "8d2c17a9b26d4d83888ea67a1ee565b2",
    "format": "mp3"
  }'

Відмінності з інтерфейсом списку

Поле	`GET /fish/model` (список)	`GET /fish/model/{id}` (деталі)
`samples[].audio`	Короткочасне R2 кешування URL	Пряме посилання R2 з підписом (включаючи підпис запиту)
`unliked` / `liked` / `marked` / `dmca_taken_down`	Так само існує	Так само існує
`default_text` / `lock_visibility`	Так само існує	Так само існує

Якщо вам просто потрібно прослухати, samples[].audio в інтерфейсі списку вже достатньо; для більш стабільного посилання на завантаження рекомендується використовувати цей інтерфейс.

Поля відповіді (вибірково)

Поле	Тип	Опис
`_id`	string	ID голосу (використовується для `/fish/tts` в `reference_id`).
`type`	string	Тип моделі, зазвичай `tts`.
`title`	string	Назва голосу.
`description`	string	Довгий опис.
`state`	string	Статус навчання: `trained` означає доступний, `training` означає, що ще триває навчання.
`tags`	string[]	Теги загальної бібліотеки.
`samples`	object[]	Попередньо задані зразки, що містять `title`, `text`, `task_id`, `audio` пряме посилання.
`languages`	string[]	Код мов, в яких голос має перевагу.
`visibility`	string	`public` або `private`.
`like_count`	integer	Кількість лайків у загальній бібліотеці.
`task_count`	integer	Кількість історичних синтезів (може використовуватися для посилання на популярність).
`author`	object	Інформація про автора: `_id` / `nickname` / `avatar`.
`created_at`	string	ISO 8601 час створення.
`updated_at`	string	ISO 8601 час останнього оновлення.

Інформація про оплату

Цей інтерфейс не підлягає оплаті — запит деталей одного голосу за ID є безкоштовною операцією. Створення голосу (Fish Model Create) також безкоштовне, витрати виникають лише під час виклику Fish TTS для синтезу голосу.

Обробка помилок

400 token_mismatched：Шляхом id не є дійсним форматом, або верхній рівень повідомляє «Модель не знайдена».
401 invalid_token：Токен авторизації не існує або недійсний.
404 not_found：Вказаний _id не видимий на Fish (зразок видалено, приватний або належить іншому обліковому запису).
429 too_many_requests：Перевищено обмеження швидкості облікового запису.
500 api_error：Внутрішня помилка сервера.

При фактичному запиті неіснуючого ID верхній рівень безпосередньо повертає 400 Model not found (перевірено):

curl 'https://api.acedata.cloud/fish/model/test123' \
  -H 'authorization: Bearer {token}'

Повертає:

{ "status": 400, "message": "Model not found" }

Приклад помилкового відповіді:

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

Висновок

Знаючи звук _id, безпосередньо використовуйте цей інтерфейс для отримання повної ModelEntity, найпоширеніше використання: (1) прослуховування samples[].audio, (2) передача _id до reference_id /fish/tts для завершення синтезу. Якщо є лише заголовок або мітки, спочатку використовуйте Fish Model Query для пошуку.

Getting Started

AI Чат

AI Зображення

AI Відео

AI Аудіо

Веб і дані

CAPTCHA

Ідентичність

Проксі

Advanced

Coding

Fish Model Get API інтеграційна інструкція

Процес подачі заявки

Параметри шляху

Приклад: отримання повних деталей публічного іспанського голосу

Відмінності з інтерфейсом списку

Поля відповіді (вибірково)

Інформація про оплату

Обробка помилок

Висновок

​Процес подачі заявки

​Параметри шляху

​Приклад: отримання повних деталей публічного іспанського голосу

​Відмінності з інтерфейсом списку

​Поля відповіді (вибірково)

​Інформація про оплату

​Обробка помилок

​Висновок

Процес подачі заявки

Параметри шляху

Приклад: отримання повних деталей публічного іспанського голосу

Відмінності з інтерфейсом списку

Поля відповіді (вибірково)

Інформація про оплату

Обробка помилок

Висновок