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

# Démarrage rapide

> Créez une clé, faites votre première requête et écoutez une phrase dite en haoussa.

5 min

Votre premier appel en cinq minutes

L’API Namu est une simple API HTTPS : chaque requête est un `POST` ou un `GET` vers `https://api.namuai-lab.com/v1/...`, avec votre clé dans l’en-tête `Authorization`. Tout ce qui sait envoyer du HTTP peut l’utiliser.

**1. Créer une clé d’API**

Connectez-vous à la [console Namu](https://www.namuai-lab.com/fr/account/keys) et ouvrez **Clés d’API**. Créez une clé, donnez-lui un nom que vous reconnaîtrez, et copiez-la. Elle commence par `namu_sk_` et ne s’affiche **qu’une fois**.

> [!WARNING]
>
> Votre clé est un mot de passe. Gardez-la sur votre serveur : ne la mettez jamais dans une application mobile, une page web ou un dépôt public. Quiconque la détient peut consommer votre quota.

**2. Enregistrer la clé dans une variable d’environnement**

Votre code lit la clé dans l’environnement : elle ne se trouve donc jamais dans un fichier que vous pourriez partager.

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

```powershell Windows (PowerShell) theme={"theme":{"light":"github-light","dark":"github-dark"}}
setx NAMU_API_KEY "namu_sk_..."
```

Sous Windows, ouvrez ensuite un nouveau terminal pour qu’il voie la variable.

**3. Faire votre première requête**

Demandez à Nadia de dire « *Sannu da zuwa! Muna farin cikin jin muryarku.* » (Bienvenue ! Nous sommes heureux d’entendre votre voix.)

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

```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": "Sannu da zuwa! Muna farin cikin jin muryarku.", "voice": "nadia"},
    timeout=120,
)
response.raise_for_status()

with open("welcome.wav", "wb") as f:
    f.write(response.content)
print("Saved", response.headers["X-Audio-Seconds"], "seconds of audio")
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { writeFile } from "node:fs/promises";

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: "Sannu da zuwa! Muna farin cikin jin muryarku.", voice: "nadia" }),
});
if (!response.ok) throw new Error((await response.json()).error.message);

await writeFile("welcome.wav", Buffer.from(await response.arrayBuffer()));
console.log("Saved", response.headers.get("X-Audio-Seconds"), "seconds of audio");
```

**4. L’écouter**

Ouvrez `welcome.wav`. C’est votre application qui parle haoussa. La première requête après un moment d’inactivité peut prendre un peu plus de temps, le temps que le modèle se réveille ; les suivantes sont plus rapides.

## Et maintenant, qu’elle écoute

Renvoyez à l’API le fichier que vous venez de créer, et lisez ce qu’elle a entendu :

```bash curl theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl https://api.namuai-lab.com/v1/transcribe \
  -H "Authorization: Bearer $NAMU_API_KEY" \
  -F file=@welcome.wav \
  -F language=ha
```

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
with open("welcome.wav", "rb") as audio:
    response = requests.post(
        "https://api.namuai-lab.com/v1/transcribe",
        headers={"Authorization": f"Bearer {os.environ['NAMU_API_KEY']}"},
        files={"file": audio},
        data={"language": "ha"},
        timeout=120,
    )
print(response.json()["text"])
```

```javascript JavaScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { readFile } from "node:fs/promises";

const form = new FormData();
form.append("file", new Blob([await readFile("welcome.wav")]), "welcome.wav");
form.append("language", "ha");

const heard = await fetch("https://api.namuai-lab.com/v1/transcribe", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.NAMU_API_KEY}` },
  body: form,
}).then((r) => r.json());
console.log(heard.text);
```

```json Réponse theme={"theme":{"light":"github-light","dark":"github-dark"}}
{
  "model": "speech-recognition",
  "text": "sannu da zuwa muna farin cikin jin muryarku",
  "language": "ha",
  "audio_seconds": 3.1
}
```

> [!NOTE]
>
> Les transcriptions sont écrites en minuscules, sans ponctuation. Ajoutez la vôtre si votre écran en a besoin.

## Étapes suivantes

> [card] [Choisir une voix](https://developers.namuai-lab.com/fr/voices-and-languages.md)
>
> Nadia en haoussa, Mouhamad en zarma et en haoussa, et la voix française.

> [card] [Traduire](https://developers.namuai-lab.com/fr/capabilities/translation.md)
>
> Du haoussa vers le français et inversement, à partir d’un texte ou de la parole.

> [card] [Utiliser un SDK](https://developers.namuai-lab.com/fr/sdks/overview.md)
>
> Un petit client Python ou JavaScript que vous pouvez coller dans votre projet.

> [card] [Suivre votre consommation](https://developers.namuai-lab.com/fr/guides/usage-and-rate-limits.md)
>
> Comment chaque requête est décomptée de vos 30 minutes gratuites.


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