> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fanifyai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fish Audio

> Configurez Fish Audio dans Fanify pour la synthèse vocale (TTS) : génération de vocaux à partir de texte par l'IA.

## Introduction

Fish Audio est un fournisseur d'inférence vocale utilisé par Fanify pour la **synthèse vocale (TTS, text-to-speech)** : la génération de messages vocaux à partir de texte par l'IA, pour les réponses automatiques vocales.

Il complète [ElevenLabs](/fr/basics/configuration/elevenlabs), qui assure de son côté le **changement de voix (STS / VoiceChanger)** en chatting. Une seule clé d'API suffit à configurer Fish Audio.

<Note>
  Dans Fanify, les deux fournisseurs vocaux ont des rôles distincts :

  * **ElevenLabs** → conversion voix (STS), pour le VoiceChanger en chatting.
  * **Fish Audio** → synthèse vocale (TTS), pour les vocaux générés à partir de texte.

  Vous pouvez configurer l'un, l'autre, ou les deux selon les fonctionnalités vocales souhaitées.
</Note>

## Prérequis

* **Un compte [fish.audio](https://fish.audio)**
* **Des crédits sur le compte** (facturation à l'usage)
* **Accès administrateur** à votre instance Fanify

<Warning>
  Sans clé Fish Audio valide, la génération de vocaux par synthèse vocale ne fonctionnera pas.
</Warning>

## Étapes

### 1) Créer une clé d'API Fish Audio

1. Connectez-vous sur [fish.audio](https://fish.audio)
2. Ouvrez la page [API Keys](https://fish.audio/go-api/)
3. **Créez une clé d'API**, donnez-lui un nom (ex : `Fanify`)
4. **Copiez** la clé générée

<Warning>
  La clé n'est affichée **qu'une seule fois**. Conservez-la en lieu sûr le temps de la coller dans Fanify.
</Warning>

### 2) Saisir la clé dans Fanify

1. Onglet **Admin** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/sidebar/tab_admin_hover.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=56afaefa40d91e63ee894ed87eb0209d" alt="Onglet Admin" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="240" height="50" data-path="assets/ui-elements/sidebar/tab_admin_hover.png" />
2. Section **Services** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/setting-item/services_fr.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=c7e656a007400c325b89bd00bd49a769" alt="Section Services" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="554" height="68" data-path="assets/ui-elements/pages/admin-settings/setting-item/services_fr.png" />
3. Cliquez sur **Fish Audio** <img src="https://mintcdn.com/saufrasoft/aFq2Mb0yAiM80Ukz/assets/ui-elements/pages/admin-settings/services/fishaudio.png?fit=max&auto=format&n=aFq2Mb0yAiM80Ukz&q=85&s=d73d5946fd4e5dfffc016242a26e9d6a" alt="Service Fish Audio" style={{ display: "inline", height: "1.8em", verticalAlign: "middle", margin: "0 0.25em" }} width="180" height="56" data-path="assets/ui-elements/pages/admin-settings/services/fishaudio.png" />
4. Collez la clé dans **Clé d'API**, puis **Enregistrer**

Une fois la clé enregistrée, les sections **Crédits**, **Modèle & voix** et **Paramètres de voix** apparaissent.

### 3) Choisir le modèle de synthèse vocale

Dans **Admin > Services > Fish Audio**, section **Modèle & voix** :

1. Cliquez sur **Actualiser les données** si la liste est vide (Fanify récupère alors les modèles disponibles)
2. Dans **Modèle**, sélectionnez le modèle souhaité (par exemple `s1` ou `s2-pro`)
3. Cliquez sur **Enregistrer**

### 4) Choisir une voix par défaut

Toujours dans **Modèle & voix** :

1. Utilisez le **sélecteur de voix** Fish Audio pour rechercher une voix dans la bibliothèque (recherche par titre, filtre par langue ou par tag) ou choisir une voix de votre compte
2. Sélectionnez la voix à utiliser par défaut
3. Cliquez sur **Enregistrer**

<Tip>
  Cette voix sert de **fallback global** pour tous les personnages qui n'ont pas leur propre voix TTS configurée.
</Tip>

### 5) (optionnel) Ajuster les paramètres de voix

Section **Paramètres de voix** : ajustez `Vitesse`, `Température` et `Top P` pour calibrer le rendu sonore, puis **Enregistrer**.

Les valeurs par défaut conviennent à la plupart des cas. La `Vitesse` contrôle le débit de parole, la `Température` la variabilité du rendu (bas = plus constant, haut = plus varié).

## Vérification

La page **Service Fish Audio** affiche les **crédits restants** sur votre compte. Utilisez **Récupérer** pour rafraîchir le solde.

<Note>
  Le solde affiché est **actualisé automatiquement** (environ toutes les 4 heures). Lorsque vos crédits sont **épuisés**, Fanify le signale par un badge **Plus de crédits** pour vous inviter à **recharger**.
</Note>

<Warning>
  Si votre clé est valide mais qu'aucune voix par défaut n'est sélectionnée, un avertissement s'affiche au-dessus des sélecteurs. Choisissez une voix puis **Enregistrez** pour le faire disparaître.
</Warning>

## Configuration vocale par personnage

La voix configurée dans **Admin > Services > Fish Audio** est utilisée par défaut pour tous les personnages. Pour donner une voix TTS spécifique à un personnage, voir [Configuration vocale du personnage](/fr/basics/configuration/voice-config).

## Dépannage rapide

* **Clé invalide / erreur d'authentification** : vérifiez la clé sur [fish.audio](https://fish.audio/go-api/), puis cliquez sur **Actualiser les données**
* **Aucun modèle listé** : enregistrez la clé d'API, puis cliquez sur **Actualiser les données**
* **Avertissement « voix non sélectionnée »** : choisissez une voix par défaut dans **Modèle & voix** et **Enregistrez**
* **Crédits à 0** : créditez votre compte sur [fish.audio](https://fish.audio)

## Liens utiles

* Site Fish Audio : [fish.audio](https://fish.audio)
* Gestion des clés d'API : [fish.audio/go-api](https://fish.audio/go-api/)