> ## Documentation Index > Fetch the complete documentation index at: https://developers.namuai-lab.com/llms.txt > Use this file to discover all available pages before exploring further. # Synthèse vocale > Transformez un texte en parole naturelle en haoussa, en zarma ou en français, avec une voix à laquelle vos auditeurs feront confiance. 4 min La synthèse vocale en haoussa, en zarma et en français ## Vue d’ensemble `POST /v1/speech` reçoit jusqu’à 2 000 caractères de texte et renvoie l’audio, dit par la voix de votre choix. Utilisez-le pour lire des messages aux personnes qui préfèrent écouter plutôt que lire : rappels de santé, conseils agricoles, leçons d’école, annonces, réponse dans une application de messagerie. * **Modèle :** `speech-synthesis` (bêta) * **Langues :** haoussa `ha`, zarma `dje`, français `fr` * **Sortie :** WAV (par défaut), MP3, Ogg Opus, ou JSON avec l’audio en base64 * **Ce qui est compté :** la durée de l’audio renvoyé ## Démarrage rapide ```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}} curl https://api.namuai-lab.com/v1/speech \ -H "Authorization: Bearer $NAMU_API_KEY" \ -H "Content-Type: application/json" \ -d '{"text": "Damina ta kama. Lokaci ya yi da manoma su fara shuka gero da dawa.", "voice": "nadia", "format": "mp3"}' \ -o farming.mp3 ``` ```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}} import os import requests response = requests.post( "https://api.namuai-lab.com/v1/speech", headers={"Authorization": f"Bearer {os.environ['NAMU_API_KEY']}"}, json={ "text": "Damina ta kama. Lokaci ya yi da manoma su fara shuka gero da dawa.", "voice": "nadia", "format": "mp3", }, timeout=120, ) response.raise_for_status() open("farming.mp3", "wb").write(response.content) ``` ```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}} const response = await fetch("https://api.namuai-lab.com/v1/speech", { method: "POST", headers: { Authorization: `Bearer ${process.env.NAMU_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ text: "Damina ta kama. Lokaci ya yi da manoma su fara shuka gero da dawa.", voice: "nadia", format: "mp3", }), }); const audio = Buffer.from(await response.arrayBuffer()); ``` *« La saison des pluies s’est installée. Il est temps pour les agriculteurs de commencer à semer le mil et le sorgho. »* ## Requête **text** `string` *required* Le texte à dire, jusqu’à 2 000 caractères. Écrivez-le comme vous voulez qu’il soit entendu : développez les abréviations que vos auditeurs ne prononceraient pas. **voice** `string` (default: nadia) `nadia` (ou son alias `warm`), `mouhamad` ou `fr`. Voir les [voix](https://developers.namuai-lab.com/fr/voices-and-languages.md). **language** `string` `ha`, `dje` ou `fr`. Par défaut, la première langue de la voix ; ce doit être une langue que la voix parle. **format** `string` (default: wav) `wav`, `mp3`, `opus` ou `json`. Voir les [formats de sortie](#formats-de-sortie). ## Voix ## Formats de sortie | `format` | Type de contenu | Audio | Idéal pour | | - | - | - | - | | `wav` | `audio/wav` | 24 kHz, PCM 16 bits, mono | Le montage, ou le passage à d’autres outils audio | | `mp3` | `audio/mpeg` | 64 kbit/s, mono | La lecture partout, sur tous les navigateurs et tous les téléphones | | `opus` | `audio/ogg` | Ogg Opus, 48 kHz, 32 kbit/s, mono | **Le fichier le plus léger.** Les données mobiles, les messages vocaux à la manière de WhatsApp | | `json` | `application/json` | WAV en base64 dans le champ `audio` | Quand votre environnement ne sait traiter que du JSON | Les formats binaires renvoient un en-tête `X-Audio-Seconds` avec la durée de l’audio. Une phrase de dix secondes pèse environ 480 Ko en WAV, 80 Ko en MP3 et 40 Ko en Opus : sur une connexion 3G, choisissez `opus` ou `mp3`. Avec `json`, la réponse ressemble à ceci : ```json theme={"theme":{"light":"github-light","dark":"github-dark"}} { "model": "speech-synthesis", "voice": "nadia", "language": "ha", "audio_seconds": 4.2, "audio": "UklGRiQAAABXQVZFZm10IBAAAAABAAEAwF0AAIC7AAACABAAZGF0YQAAAAA...", "sample_rate": 24000 } ``` ## Bonnes pratiques > [accordion] Faites des phrases courtes > > Une idée par phrase s’entend plus clairement et se suit plus facilement sur le haut-parleur d’un téléphone. Pour un long texte, envoyez-le paragraphe par paragraphe et jouez les morceaux l’un après l’autre : la lecture du premier commence plus tôt. > [accordion] Écrivez les nombres et les dates comme on les dit > > Écrivez « goma sha biyar » plutôt que « 15 » quand un nombre doit être dit d’une certaine façon, et écrivez en toutes lettres les dates, les prix et les abréviations. Vous décidez exactement de ce qui est entendu. > [accordion] Générez une fois, diffusez autant que vous voulez > > Un rappel envoyé à mille personnes, c’est le même audio. Générez-le une fois, stockez le fichier et servez-le depuis votre propre stockage : vous économisez votre quota et le chargement est plus rapide pour tout le monde. > [accordion] Attendez-vous à de petites différences d’une prise à l’autre > > Le modèle dit une phrase un peu différemment à chaque fois. Si une prise compte (une annonce, un jingle), générez-en deux ou trois et gardez celle que vous préférez. > [accordion] Dites aux gens que la voix est une IA > > Indiquez aux auditeurs que la voix est générée, surtout pour des informations de santé, d’argent ou officielles. Voir l’[usage responsable](https://developers.namuai-lab.com/fr/resources/responsible-use.md). ## Limites * Jusqu’à 2 000 caractères par requête (`413 text_too_long` au-delà). * Pas encore de diffusion en continu : le fichier entier arrive en une fois. * La première requête après un moment d’inactivité est plus lente, le temps que le modèle se réveille. ## Voir aussi > [card] [Lire à voix haute en haoussa](https://developers.namuai-lab.com/fr/tutorials/read-aloud-in-hausa.md) > > Tutoriel > [card] [Formats audio](https://developers.namuai-lab.com/fr/guides/audio-formats.md) > > Guide > [card] [Référence de l’API](https://developers.namuai-lab.com/fr/api-reference/speech/create-speech.md) > > POST /v1/speech This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.