Інструкція з інтеграції API створення Fish Model

Якщо вам потрібно лише тимчасово використати еталонний голос, немає потреби створювати модель — можна безпосередньо використати одноразове миттєве клонування через references у Fish TTS API. Для посторінкового пошуку наявних голосів дивіться Fish Model Query API; для отримання деталей одного голосу за _id дивіться Fish Model Get API.

​

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

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

​

Поля тіла запиту

Докладнішу інформацію про моделі голосу дивіться в офіційній документації Fish.

Створений голос буде збережено у відкритому доступі на тривалий час, і інші користувачі можуть шукати та використовувати його. Не потрібно передавати visibility; навіть якщо передати private або unlist, поточний API не змінить на цій підставі область публічного доступу.

​

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

curl -X POST 'https://api.acedata.cloud/fish/model' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "title": "我的克隆音色",
    "description": "用一段播客录音克隆的中文音色",
    "voices": "https://example.com/sample-voice.mp3",
    "cover_image": "https://cdn.acedata.cloud/e724d7f13d.png"
  }'

Зверніть увагу: voices має бути рядком (один URL аудіо), а не масивом. Якщо передати як ["..."], upstream відхилить запит. Рекомендується використовувати загальнодоступне пряме посилання, яке можна завантажити, із суфіксом .mp3 або .wav.

{
  "_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
  "type": "tts",
  "title": "copilot-smoke-test",
  "description": "smoke test from api.acedata.cloud",
  "cover_image": "coverimage/e5c6db52c3ed417f9cb2e5a33fb04667",
  "train_mode": "fast",
  "state": "trained",
  "tags": [],
  "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",
  "updated_at": "2026-05-10T03:52:55.601000Z",
  "languages": ["zh"],
  "visibility": "public",
  "default_text": "师父，[语气坚定]我真的受够了这山上的清冷日子！...",
  "like_count": 0,
  "mark_count": 0,
  "shared_count": 0,
  "task_count": 0,
  "author": {
    "_id": "780f2b2f862d41a08c0507bbbda77eb6",
    "nickname": "Penny Conrad",
    "avatar": "avatars/780f2b2f862d41a08c0507bbbda77eb6.jpg"
  }
}

curl -X POST 'https://api.acedata.cloud/fish/tts' \
  -H 'authorization: Bearer {token}' \
  -H 'content-type: application/json' \
  -d '{
    "text": "你好，这是一段使用我刚创建的克隆音色合成的语音。",
    "reference_id": "e5c6db52c3ed417f9cb2e5a33fb04667",
    "format": "mp3"
  }'

​

Вимоги до зразків

• Рекомендована тривалість — понад 30 секунд, найкращий результат — до 5 хвилин; після 10 хвилин гранична користь невелика.
• Частота дискретизації 16 кГц і вище, підходять як моно, так і стерео.
• Вміст має бути якомога чистішим: без фонової музики, луни та помітного шуму середовища; один і той самий мовник.
• Рекомендовані формати: mp3 / wav.

​

Опис тарифікації

​

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

• 400 token_mismatched: параметри запиту відсутні або недійсні (найчастіше voices не є URL або передано як масив).
• 400: якщо еталонне аудіо неможливо завантажити, його тривалість надто коротка або формат не розпізнається, перевірте URL аудіо та формат файлу.
• 401 invalid_token: токен автентифікації не існує або недійсний.
• 429 too_many_requests: спрацьовує обмеження швидкості для облікового запису.
• 500 api_error: внутрішня помилка сервера.

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "voices is required and must be an HTTP(S) URL pointing to an audio file"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​

Висновок

​

Створення та повторне використання голосу через MCP