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

> Apprenez à vous authentifier avec l'API VoiceCheap

# Authentification

L'API VoiceCheap utilise des clés API pour l'authentification. Toutes les requêtes API doivent inclure votre clé API dans l'en-tête `x-api-key`.

## Obtenir votre clé API

<Steps>
  <Step title="Connectez-vous à VoiceCheap">
    Allez sur [app.voicecheap.ai](https://app.voicecheap.ai) et connectez-vous à votre compte.
  </Step>

  <Step title="Accédez à la page API">
    Allez sur la page **API** à l'adresse [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
  </Step>

  <Step title="Générer une clé API">
    Cliquez sur **Créer une nouvelle clé** et donnez un nom à votre clé. Votre clé API complète ne sera affichée qu'une seule fois - copiez-la et stockez-la immédiatement en lieu sûr.
  </Step>
</Steps>

<Warning>
  **Important : Enregistrez votre clé immédiatement**

  Votre clé API complète n'est affichée qu'**une seule fois** lors de sa création. Après avoir fermé la fenêtre modale, vous ne verrez qu'une version masquée (`vc_abc...xyz`). Si vous perdez votre clé, vous devrez la supprimer et en créer une nouvelle.
</Warning>

## Limites des clés API

* Vous pouvez créer un **maximum de 5 clés API** par compte
* Chaque clé peut être nommée pour une identification facile (par exemple, "Production", "Développement")
* Les clés peuvent être supprimées à tout moment depuis la page API

## Utilisation de votre clé API

Incluez votre clé API dans l'en-tête `x-api-key` avec chaque requête :

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST https://api.voicecheap.ai/v1/translate \
    -H "x-api-key: vc_your-api-key-here" \
    -F "file=@video.mp4" \
    -F "targetLanguage=spanish"
  ```

  ```typescript TypeScript theme={null}
  const formData = new FormData();
  formData.append('file', videoFile);
  formData.append('targetLanguage', 'spanish');

  const response = await fetch('https://api.voicecheap.ai/v1/translate', {
    method: 'POST',
    headers: {
      'x-api-key': 'vc_your-api-key-here'
    },
    body: formData
  });

  const data = await response.json();
  ```

  ```javascript JavaScript theme={null}
  const formData = new FormData();
  formData.append('file', videoFile);
  formData.append('targetLanguage', 'spanish');

  const response = await fetch('https://api.voicecheap.ai/v1/translate', {
    method: 'POST',
    headers: {
      'x-api-key': 'vc_your-api-key-here'
    },
    body: formData
  });

  const data = await response.json();
  ```

  ```python Python theme={null}
  import requests

  files = {'file': open('video.mp4', 'rb')}
  data = {'targetLanguage': 'spanish'}
  headers = {'x-api-key': 'vc_your-api-key-here'}

  response = requests.post(
      'https://api.voicecheap.ai/v1/translate',
      headers=headers,
      files=files,
      data=data
  )
  ```
</CodeGroup>

## Prérequis

<Warning>
  **Abonnement payant requis**

  L'accès à l'API nécessite un abonnement payant actif. Les comptes gratuits ne peuvent pas utiliser l'API. Si vous tentez d'utiliser l'API sans abonnement valide, vous recevrez une erreur `403 Forbidden`.
</Warning>

## Sécurité des clés API

<CardGroup cols={2}>
  <Card title="Gardez-la secrète" icon="lock">
    Ne divulguez jamais votre clé API dans le code côté client, dans des dépôts publics ou dans tout emplacement accessible au public.
  </Card>

  <Card title="Utilisez des variables d'environnement" icon="shield">
    Stockez votre clé API dans des variables d'environnement ou dans un gestionnaire de secrets sécurisé.
  </Card>

  <Card title="Renouvelez régulièrement" icon="rotate">
    Renouvelez périodiquement vos clés API, surtout si vous soupçonnez qu'elles ont pu être compromises.
  </Card>

  <Card title="Surveillez l'utilisation" icon="eye">
    Suivez l'utilisation de votre API pour détecter tout accès non autorisé.
  </Card>
</CardGroup>

## Réponses d'erreur

Si l'authentification échoue, vous recevrez l'une des erreurs suivantes :

| Code d'état | Code d'erreur            | Description                                                                 |
| ----------- | ------------------------ | --------------------------------------------------------------------------- |
| 401         | `MISSING_API_KEY`        | L'en-tête `x-api-key` n'a pas été fourni                                    |
| 401         | `INVALID_API_KEY_FORMAT` | La clé API n'utilise pas le préfixe `vc_` attendu                           |
| 401         | `INVALID_API_KEY`        | La clé API fournie est invalide                                             |
| 403         | `API_ACCESS_REQUIRED`    | L'accès à l'API n'est pas activé pour ce compte                             |
| 403         | `SUBSCRIPTION_REQUIRED`  | L'accès à l'API nécessite un abonnement payant actif                        |
| 403         | `INSUFFICIENT_CREDITS`   | Votre compte ne dispose pas de suffisamment de crédits pour cette opération |

## Exemple de réponse d'erreur

```json theme={null}
{
  "code": "INVALID_API_KEY",
  "message": "The provided API key is invalid. Please check your API key and try again."
}
```