POST https://api.acedata.cloud/fish/model.
Якщо вам потрібно тимчасово використовувати референсний звук, модель створювати не потрібно, можна безпосередньо використовувати Fish TTS API зreferencesдля одноразового миттєвого клонування. Для пагінованого пошуку існуючих звуків зверніться до Fish Model Query API; для запиту деталей окремого звуку за_idзверніться до Fish Model Get API.
Процес подачі заявки
Щоб використовувати Fish Model API, спочатку перейдіть до Ace Data Cloud консолі для отримання вашого API Token, зберігайте його для подальшого використання.
Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на цю сторінку.
Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо запитувати для кожної послуги. Перший запит на отримання токена надає безкоштовний ліміт для тестування; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: Fish Model API →
Поля тіла запиту
Поля повністю відповідають верхньому рівню, будь ласка, також зверніться до Fish офіційної документації.
Приклад: створення приватного клонованого звуку
Зверніть увагу:Успішна відповідь повертає об’єкт ModelEntity платформи Fish (нижче наведено наш мінімальний тестований звук, частини довгих полів видалено для зручності читання):voicesмає бути рядком (один аудіо URL), а не масивом. Якщо передати як["..."], верхній рівень відмовить.
_id може бути використаний як значення поля reference_id в подальшому Fish TTS API для використання цього клонованого звуку для синтезу мови:
Вимоги до зразків
Рекомендації (відповідають верхньому рівню, можна звернутися до Fish офіційної документації):- Рекомендується тривалість від 30 секунд до 5 хвилин; понад 10 хвилин маргінальна вигода незначна.
- Частота дискретизації 16 кГц і вище, моно або стерео.
- Зміст має бути якомога чистішим: без фонової музики, відлуння, явного шуму навколишнього середовища; один і той же спікер.
- Рекомендується формат
mp3/wav.
enhance_audio_quality: true, щоб верхній рівень спочатку покращив якість звуку.
Інформація про тарифи
Створення клонованої звукової моделі (POST /fish/model) безкоштовне, жодних витрат не стягується; інтерфейси запиту звуку (Fish Model Query, Fish Model Get) також не підлягають оплаті. Витрати виникають лише під час подальшого виклику Fish TTS для синтезу мови.
Обробка помилок
400 token_mismatched:параметри запиту відсутні або недійсні (найпоширеніша причина -voicesне є URL, або передано у вигляді масиву).401 invalid_token:токен авторизації відсутній або недійсний.429 too_many_requests:активовано обмеження швидкості облікового запису.500 api_error:внутрішня помилка сервера.
Висновок
Для виклику цього інтерфейсу потрібно підготувати зразок аудіо URL, доступний для публічного доступу, помістити його в полеvoices, щоб отримати _id, а потім передати його в reference_id для /fish/tts, щоб завершити процес «клонування → синтезу». Поширена помилка - voices повинно бути рядком, а не масивом.
