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

# Glossaire

> Les mots de cette documentation, réunis au même endroit.

**Bêta**

Prêt pour construire avec de vrais utilisateurs, pendant que la qualité continue de s’améliorer. Les changements qui pourraient casser votre intégration sont annoncés dans l’historique des versions.

**Clé d’API**

Un secret qui commence par `namu_sk_` et identifie votre compte. Elle reste sur votre serveur et s’envoie en `Authorization: Bearer`.

**Code de langue**

`ha` haoussa, `dje` zarma, `fr` français : les codes ISO 639 qu’utilise l’API.

**Identifiant de requête**

Un identifiant unique pour chaque réponse, dans `X-Request-Id` et dans le corps des erreurs. Envoyez-le-nous quand quelque chose ne va pas.

**Limite de débit**

Requêtes par minute et par clé : 60 par défaut. La dépasser renvoie `429 rate_limited` avec `Retry-After`.

**Opus**

Un format audio compact pour la parole. L’API le renvoie avec `"format": "opus"` (Ogg Opus) et le lit dans les notes vocales.

**Permission (scope)**

Ce qu’une clé peut appeler : `transcribe`, `speech`, `translate`, `converse`. Les nouvelles clés reçoivent toutes les permissions sauf `converse`.

**Personnage (persona)**

Qui répond dans l’agent vocal. `nadia` est le seul.

**Quota**

Les secondes d’audio qu’un compte peut utiliser chaque mois : 1 800 (30 minutes) pendant la bêta. Remis à zéro le 1er de chaque mois, en UTC.

**Quota épuisé**

`429 quota_exceeded` : le quota du mois est utilisé. À distinguer de `rate_limited`, qui passe au bout de quelques secondes.

**Recherche**

Un aperçu d’un travail en cours, comme l’agent vocal. Il peut changer sans préavis.

**Secondes d’audio**

L’unité dans laquelle tout est compté : la durée de l’audio envoyé ou renvoyé. La traduction de texte compte les caractères ÷ 15.

**Voix**

Qui parle dans `/v1/speech` : `nadia` (ou `warm`), `mouhamad`, `fr`. Chacune est utilisée avec le consentement de la personne dont c’est la voix.


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