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

# Authentification

> Authentifiez les requêtes API et les clients MCP avec des identifiants aux autorisations définies.

# Authentification

Utilisez une clé API dans l’en-tête `x-api-key` ou comme identifiant `Authorization: Bearer`. Les clients MCP distants peuvent aussi se connecter via OAuth. Les jetons d’accès OAuth sont valables uniquement pour la ressource MCP ; utilisez une clé API pour les appels REST.

## Créer une clé à autorisations limitées

Ouvrez les [Intégrations](https://app.voicecheap.ai/page-api), créez une clé et sélectionnez ses autorisations et, si nécessaire, une expiration. La clé complète n’est affichée qu’une fois. Conservez-la dans votre gestionnaire de secrets. Vous pourrez ensuite la renommer, modifier ses autorisations ou son expiration, ou la révoquer.

## Autorisations

Chaque action indique les autorisations nécessaires dans le [catalogue des actions](https://api-docs.voicecheap.ai/docs/fr/api-reference/actions.md). Une action peut nécessiter plusieurs autorisations. La lecture n’accorde pas le droit de créer, de modifier ou de supprimer. Les clés existantes sans autorisations explicites conservent uniquement leur accès antérieur aux projets et à la transcription ; modifiez-les ou remplacez-les pour activer les nouvelles fonctionnalités.

| Domaine | Lecture | Écriture ou suppression |
| - | - | - |
| Compte | `account:read` | — |
| Utilisation | `usage:read` | — |
| Paramètres | `settings:read` | `settings:write` |
| Équipe | `team:read` | `team:write` |
| Projets | `projects:read` | `projects:write`, `projects:delete` |
| Traduction | — | `translations:write` |
| Transcription | `transcription:read` | `transcription:write` |
| Sous-titres | `subtitles:read` | `subtitles:write` |
| Synthèse vocale | `tts:read` | `tts:write` |
| Voix | `voices:read` | `voices:write` |
| Images | `images:read` | `images:write` |
| Miniatures | `thumbnails:read` | `thumbnails:write` |
| Dossiers | `folders:read` | `folders:write` |
| Glossaire | `glossary:read` | `glossary:write` |
| Webhooks | `webhooks:read` | `webhooks:write` |
| Publication | `publishing:read` | `publishing:write` |

Les autorisations limitent un identifiant ; elles ne modifient ni votre abonnement, ni votre rôle dans l’équipe, ni la propriété des projets, ni vos crédits média disponibles. Les modifications administratives de l’équipe restent réservées à son propriétaire.

## Exemple d’en-tête

Cette requête de découverte répertorie uniquement les actions autorisées par votre clé. Ne placez pas de clé API dans du code exécuté dans le navigateur ou dans un dépôt public.

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "x-api-key: vc_your-api-key"
```

```bash theme={null}
curl "https://api.voicecheap.ai/v1/actions" \
  -H "Authorization: Bearer vc_your-api-key"
```

## Connexions OAuth

Pour les assistants compatibles, utilisez la [connexion MCP distante](https://api-docs.voicecheap.ai/docs/fr/ai/model-context-protocol.md) et connectez-vous à VoiceCheap. Examinez les autorisations sur l’écran de consentement. Vous pouvez révoquer chaque connexion dans les Intégrations sans supprimer vos clés API.

## Points de terminaison REST existants

Les routes existantes d’import de fichiers, de traduction, de projets et de transcriptions continuent d’accepter les clés API et appliquent désormais l’autorisation appropriée. Consultez la [référence API](https://api-docs.voicecheap.ai/docs/fr/api-reference/introduction.md) pour leurs paramètres et les [limites](https://api-docs.voicecheap.ai/docs/fr/api-reference/limits.md) pour les règles d’utilisation.


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