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

# Authentifizierung

> Erfahren Sie, wie Sie sich mit der VoiceCheap API authentifizieren

# Authentifizierung

Die VoiceCheap API verwendet API-Schlüssel zur Authentifizierung. Alle API-Anfragen müssen Ihren API-Schlüssel im `x-api-key`-Header enthalten.

## Abrufen Ihres API-Schlüssels

<Steps>
  <Step title="Melden Sie sich bei VoiceCheap an">
    Gehen Sie zu [app.voicecheap.ai](https://app.voicecheap.ai) und melden Sie sich bei Ihrem Konto an.
  </Step>

  <Step title="Navigieren Sie zur API-Seite">
    Gehen Sie zur **API**-Seite unter [app.voicecheap.ai/page-api](https://app.voicecheap.ai/page-api).
  </Step>

  <Step title="API-Schlüssel generieren">
    Klicken Sie auf **Neuen Schlüssel erstellen** und geben Sie Ihrem Schlüssel einen Namen. Ihr vollständiger API-Schlüssel wird nur einmal angezeigt – kopieren und speichern Sie ihn sofort sicher.
  </Step>
</Steps>

<Warning>
  **Wichtig: Speichern Sie Ihren Schlüssel sofort**

  Ihr vollständiger API-Schlüssel wird bei der Erstellung **nur einmal** angezeigt. Nach dem Schließen des Modals sehen Sie nur noch eine maskierte Version (`vc_abc...xyz`). Wenn Sie Ihren Schlüssel verlieren, müssen Sie ihn löschen und einen neuen erstellen.
</Warning>

## Limits für API-Schlüssel

* Sie können maximal **5 API-Schlüssel** pro Konto erstellen
* Jeder Schlüssel kann zur einfachen Identifizierung benannt werden (z. B. "Produktion", "Entwicklung")
* Schlüssel können jederzeit auf der API-Seite gelöscht werden

## Verwendung Ihres API-Schlüssels

Fügen Sie Ihren API-Schlüssel bei jeder Anfrage in den `x-api-key`-Header ein:

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

## Anforderungen

<Warning>
  **Kostenpflichtiges Abonnement erforderlich**

  Der API-Zugriff erfordert ein aktives kostenpflichtiges Abonnement. Kostenlose Konten können die API nicht nutzen. Wenn Sie versuchen, die API ohne ein gültiges Abonnement zu verwenden, erhalten Sie einen `403 Forbidden`-Fehler.
</Warning>

## Sicherheit des API-Schlüssels

<CardGroup cols={2}>
  <Card title="Geheim halten" icon="lock">
    Geben Sie Ihren API-Schlüssel niemals in clientseitigem Code, öffentlichen Repositories oder an öffentlich zugänglichen Orten preis.
  </Card>

  <Card title="Umgebungsvariablen verwenden" icon="shield">
    Speichern Sie Ihren API-Schlüssel in Umgebungsvariablen oder einem sicheren Secrets-Manager.
  </Card>

  <Card title="Regelmäßig rotieren" icon="rotate">
    Rotieren Sie Ihre API-Schlüssel regelmäßig, insbesondere wenn Sie vermuten, dass sie kompromittiert wurden.
  </Card>

  <Card title="Nutzung überwachen" icon="eye">
    Verfolgen Sie Ihre API-Nutzung, um unbefugte Zugriffe zu erkennen.
  </Card>
</CardGroup>

## Fehlerantworten

Wenn die Authentifizierung fehlschlägt, erhalten Sie einen der folgenden Fehler:

| Statuscode | Fehlercode               | Beschreibung                                                       |
| ---------- | ------------------------ | ------------------------------------------------------------------ |
| 401        | `MISSING_API_KEY`        | Der `x-api-key`-Header wurde nicht bereitgestellt                  |
| 401        | `INVALID_API_KEY_FORMAT` | Der API-Schlüssel verwendet nicht das erwartete `vc_`-Präfix       |
| 401        | `INVALID_API_KEY`        | Der bereitgestellte API-Schlüssel ist ungültig                     |
| 403        | `API_ACCESS_REQUIRED`    | Der API-Zugriff ist für dieses Konto nicht aktiviert               |
| 403        | `SUBSCRIPTION_REQUIRED`  | Der API-Zugriff erfordert ein aktives kostenpflichtiges Abonnement |
| 403        | `INSUFFICIENT_CREDITS`   | Ihr Konto verfügt nicht über genügend Guthaben für diesen Vorgang  |

## Beispiel für eine Fehlerantwort

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