> ## Documentation Index
> Fetch the complete documentation index at: https://docs.zelinqa.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Utilisation et limites

> Comment l'utilisation est comptée et quelles limites s'appliquent à l'API NBQ Engine.

## Comment l'utilisation est comptée

L'utilisation est comptée **par conversation**, indexée par votre `session_id`.

* Le premier appel avec un nouveau `session_id` enregistre la conversation.
* Les appels suivants avec le même `session_id` appartiennent à cette conversation et ne sont pas comptés à nouveau.
* Votre consommation actuelle, l'allocation restante et tout dépassement sont visibles sur le **Tableau de bord**.

## Limites du plan

Les plans peuvent inclure un nombre de conversations par période (mensuelle ou annuelle). Selon votre contrat, le dépassement est soit :

* **Facturé** — les conversations au-delà de votre allocation sont facturées au tarif par conversation.
* **Bloqué** — les requêtes retournent `HTTP 429` lorsque le quota est atteint.

## Limites des champs API

| Champ                            | Limite                          |
| -------------------------------- | ------------------------------- |
| `session_id`                     | 1 à 128 caractères              |
| `conversation_history`           | Jusqu'à 50 messages             |
| `conversation_history[].content` | 1 à 2000 caractères par message |
| `context`                        | Jusqu'à 8000 caractères         |
| `answered_question_ids`          | Jusqu'à 200 entrées             |
| `metadata` de conversion         | Taille sérialisée ≤ 4096 octets |
| Taille du fichier d'import CSV   | Jusqu'à 2 Mo                    |

## Limitation du débit

La limitation du débit est appliquée au niveau de l'API. Lorsque vous la dépassez, les requêtes retournent **HTTP 429**. Attendez et réessayez avec un backoff exponentiel.

## Banque de questions minimale

L'onglet Clé API dans le NBQ Studio est **verrouillé** jusqu'à ce que votre instance NBQ ait au moins **10 questions actives**. L'API ne peut pas traiter de trafic tant que ce seuil n'est pas atteint.