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

# SDK

> Utilisez l’API Namu depuis Python, JavaScript, Android, iOS ou tout langage capable d’envoyer des requêtes HTTP.

3 min

Choisir comment appeler l’API Namu

L’API Namu repose simplement sur HTTPS et JSON : tous les langages peuvent donc l’appeler. Pour Python et JavaScript, il existe des bibliothèques officielles : installez-en une et appelez `client.speech(...)`, `client.transcribe(...)`, `client.translate(...)`. Elles lisent votre clé dans `NAMU_API_KEY`, réessaient ce qui peut l’être sans risque, typent chaque réponse et lèvent une classe d’erreur par statut, avec son code stable et l’identifiant de la requête.

## Bibliothèques

| Langage | Installation | Dépend de | Fonctionne sur |
| - | - | - | - |
| [Python](https://developers.namuai-lab.com/fr/sdks/python.md) | `pip install namu-ai` | `requests` | Python 3.9+ |
| [JavaScript et TypeScript](https://developers.namuai-lab.com/fr/sdks/javascript.md) | `npm install namu-ai` | rien | Node 18+, Deno, Bun, Cloudflare Workers |
| [Tout langage](https://developers.namuai-lab.com/fr/sdks/http.md) | HTTP, ou un client généré à partir de notre fichier OpenAPI | une bibliothèque HTTP | partout |

## Applications mobiles

Les applications mobiles parlent à **votre serveur**, et votre serveur parle à Namu : une clé placée dans une application peut en être extraite. Les pages mobiles montrent les deux moitiés.

| Plateforme | Page | Ce qu’elle montre |
| - | - | - |
| Android | [Android (Kotlin)](https://developers.namuai-lab.com/fr/sdks/android.md) | Enregistrer une note vocale, l’envoyer à votre serveur, lire la réponse |
| iOS | [iOS (Swift)](https://developers.namuai-lab.com/fr/sdks/ios.md) | La même chose avec `AVAudioRecorder` et `URLSession` |

## Créer et exporter une clé d’API

Chaque client lit la clé dans l’environnement :

```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_..."
```

Créez une clé dans la [console](https://www.namuai-lab.com/fr/account/keys). Pour en savoir plus, voir [Clés d’API](https://developers.namuai-lab.com/fr/guides/api-keys.md).

## Le même appel dans chaque langage

```python Python theme={"theme":{"light":"github-light","dark":"github-dark"}}
from namu import Namu

client = Namu()
audio = client.speech("Sannu da zuwa!", voice="nadia", format="mp3")
open("welcome.mp3", "wb").write(audio)
```

```typescript TypeScript theme={"theme":{"light":"github-light","dark":"github-dark"}}
import { writeFile } from "node:fs/promises";
import { Namu } from "namu-ai";

const namu = new Namu();
const audio = await namu.speech("Sannu da zuwa!", { voice: "nadia", format: "mp3" });
await writeFile("welcome.mp3", Buffer.from(audio));
```

```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!", "voice": "nadia", "format": "mp3"}' \
  -o welcome.mp3
```

## Bibliothèques de la communauté

Aucune pour l’instant. Si vous créez une bibliothèque Namu pour Dart, PHP, Go, Kotlin ou un autre langage, [dites-le-nous](https://developers.namuai-lab.com/fr/resources/support.md) et nous l’ajouterons ici. Les bibliothèques de la communauté ne sont pas maintenues par Namu : vérifiez-les avant de les utiliser.


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