> ## 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.

# Votre premier appel en cinq minutes

> Créez une clé, envoyez une requête, et entendez votre application parler haoussa.

5 min

Votre premier appel en cinq minutes

**Il vous faut :** un ordinateur avec un terminal, et cinq minutes. Rien à installer : `curl` est déjà présent sur macOS, Linux et Windows 10 et versions ultérieures.

**1. Inscrivez-vous et créez une clé**

Allez sur [namuai-lab.com/fr/account/keys](https://www.namuai-lab.com/fr/account/keys), créez un compte, puis cliquez sur **Créer une clé secrète**. Copiez la clé : elle n’est affichée qu’une fois.

**2. Mettez la clé dans votre terminal**

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
export NAMU_API_KEY="namu_sk_..."
```

Dans Windows PowerShell : `$env:NAMU_API_KEY = "namu_sk_..."`

**3. Demandez à Nadia de parler**

```bash 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": "Sannu da zuwa! Muna farin cikin jin muryarku.", "voice": "nadia", "format": "mp3"}' \
  -o welcome.mp3
```

La première requête après une période calme peut prendre jusqu’à une minute. La suivante est plus rapide.

**4. Écoutez**

Ouvrez `welcome.mp3` : *« Bienvenue ! Nous sommes heureux d’entendre votre voix. »* Essayez ensuite le zarma :

```bash 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": "Fofo! Mate ni go?", "voice": "mouhamad", "format": "mp3"}' \
  -o fofo.mp3
```

## Si quelque chose ne va pas

| Vous voyez | Faites ceci |
| - | - |
| `missing_api_key` | L’`export` n’a pas atteint ce terminal. Relancez-le dans la même fenêtre. |
| `invalid_api_key` | La clé n’a été copiée qu’en partie. Copiez-la à nouveau, ou créez-en une nouvelle. |
| Le fichier ne se lit pas | Ouvrez-le dans un éditeur de texte : s’il commence par `{"error"`, le message dit pourquoi. |

## Et ensuite

> [card] [Démarrage rapide](https://developers.namuai-lab.com/fr/quickstart.md)
>
> La même chose, en Python et en JavaScript

> [card] [Lire des messages à voix haute](https://developers.namuai-lab.com/fr/tutorials/read-aloud-in-hausa.md)
>
> Tutoriel suivant


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.