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

# Référence de l’API

> Chaque point d’accès, champ et réponse de l’API Namu. Essayez-les depuis cette page avec votre propre clé.

## URL de base

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://api.namuai-lab.com
```

Tous les points d’accès se trouvent sous `/v1`. Les requêtes et les réponses passent uniquement par HTTPS.

## Points d’accès

| Méthode | Point d’accès | Ce qu’il fait | Clé |
| - | - | - | :-: |
| `POST` | [`/v1/speech`](https://developers.namuai-lab.com/fr/api-reference/speech/create-speech) | Synthèse vocale | ✓ |
| `POST` | [`/v1/transcribe`](https://developers.namuai-lab.com/fr/api-reference/transcription/create-transcription) | Transcription | ✓ |
| `POST` | [`/v1/translate`](https://developers.namuai-lab.com/fr/api-reference/translation/create-translation) | Haoussa ⇄ français, texte ou parole | ✓ |
| `POST` | [`/v1/converse`](https://developers.namuai-lab.com/fr/api-reference/voice-agent/converse) | Un tour de parole avec l’agent vocal (recherche) | ✓ |
| `GET` | [`/v1/models`](https://developers.namuai-lab.com/fr/api-reference/models-and-voices/list-models) | Les modèles et leurs langues | |
| `GET` | [`/v1/voices`](https://developers.namuai-lab.com/fr/api-reference/models-and-voices/list-voices) | Les voix | |
| `GET` | [`/v1/usage`](https://developers.namuai-lab.com/fr/api-reference/account/get-usage) | Votre consommation ce mois-ci | ✓ |
| `GET` | [`/v1/health`](https://developers.namuai-lab.com/fr/api-reference/account/health) | Indique si l’API répond | |

## Conventions

* **Authentification :** `Authorization: Bearer namu_sk_...`. Voir [Authentification](https://developers.namuai-lab.com/fr/api-reference/authentication.md).
* **Corps :** du JSON pour le texte (`/v1/speech`, traduction de texte) ; pour l’audio, du multipart avec un champ `file`, ou l’audio brut comme corps.
* **Erreurs :** toujours `{"error": {"type", "message", "request_id"}}`. Voir [Erreurs](https://developers.namuai-lab.com/fr/api-reference/errors.md).
* **Identifiants de requête :** chaque réponse porte un en-tête `X-Request-Id`.
* **Pas encore de diffusion en continu :** chaque réponse arrive en entier.
* **Versions :** la version figure dans le chemin (`/v1`). Des champs peuvent être ajoutés aux réponses à tout moment ; tout ce qui casserait une intégration est annoncé à l’avance dans l’[historique des versions](https://developers.namuai-lab.com/fr/resources/changelog.md).

## OpenAPI

La référence est générée à partir d’une description OpenAPI 3.1 de l’API. Téléchargez-la pour générer un client dans votre langage, ou importez-la dans Postman, Insomnia ou Bruno :

> [card] [openapi.yaml](https://developers.namuai-lab.com/fr/api-reference/openapi.yaml)
>
> L’API Namu en OpenAPI 3.1.


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