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

# Référence API

> Endpoints de l'API Gradium pour la synthèse vocale, la transcription, les voix, Voice Design, les prononciations et le suivi de consommation

## Bienvenue

L'API Gradium fournit des fonctionnalités de synthèse vocale (TTS) et de transcription (STT) de haute qualité et à faible latence. Cette référence documente tous les endpoints REST et WebSocket disponibles.

<Card title="Spécification OpenAPI" icon="file-code" href="/api-reference/openapi.json">
  Téléchargez le fichier de spécification OpenAPI
</Card>

## Authentification

Tous les endpoints de l'API sont authentifiés par une clé API transmise dans l'en-tête `x-api-key` :

```bash theme={null}
x-api-key: your_api_key
```

## URL du serveur

Utilisez l'URL de base suivante pour tous les endpoints REST :

```
https://api.gradium.ai/api
```

Pour les endpoints WebSocket, utilisez :

```
wss://api.gradium.ai/api
```

## Résidence des données

`api.gradium.ai` dessert toutes les régions : les requêtes sont routées vers le
cluster le plus proche, sans URL régionale à configurer et sans engagement de
résidence.

Les organisations qui ont besoin que leurs sessions restent dans une seule
région peuvent activer la résidence des données et utiliser `eu.api.gradium.ai`
ou `us.api.gradium.ai` à la place (même API, mêmes clés). Chaque réponse indique
alors la résidence obtenue, dans l'en-tête `x-gradium-residency` pour REST et
dans le champ `residency` du message WebSocket `ready`. Consultez
[Résidence des données](/fr/guides/data-residency).


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