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

# API-Referenz

> Vollständige Referenz für die VoiceCheap REST-API

# API-Referenz

Die VoiceCheap-API verwendet Standard-HTTP-Methoden und -Statuscodes. Die meisten Endpunkte geben JSON zurück; Transkript-Exporte können auch SRT oder VTT zurückgeben.

Verwenden Sie für Kontoeinstellungen, Teamverwaltung, Medientools und weitere Abläufe den [Aktionskatalog](https://api-docs.voicecheap.ai/docs/de/api-reference/actions.md). Diese Abläufe sind auch über den [MCP-Server für das Konto](https://api-docs.voicecheap.ai/docs/de/ai/model-context-protocol.md) verfügbar. Das Erstellen und Rotieren von Webhook-Signaturschlüsseln erfordert jedoch REST. Verwalten Sie Zugangsdaten unter [Integrationen](https://api-docs.voicecheap.ai/docs/de/ai/integrations.md) und prüfen Sie die [Nutzungslimits](https://api-docs.voicecheap.ai/docs/de/api-reference/limits.md).

## Basis-URL

Alle API-Anfragen sollten an folgende Adresse gerichtet werden:

```text theme={null}
https://api.voicecheap.ai
```

## Authentifizierung

Authentifizieren Sie private REST-Aufrufe mit einem API-Schlüssel in `x-api-key` oder `Authorization: Bearer`. Das OpenAPI-Dokument ist öffentlich. Informationen zu Zugangsdaten mit begrenzten Berechtigungen und OAuth für MCP finden Sie unter [Authentifizierung](https://api-docs.voicecheap.ai/docs/de/authentication.md).

## JSON-Aktions-API

Die Bereiche für Konto, Team, Projekte, Stimmen und Medienwerkzeuge dokumentieren jede JSON-Aktion einzeln. Alle diese Routen verwenden `POST`, auch zum Lesen und Löschen; senden Sie die Argumente im JSON-Body. Die Datei-Upload- und bestehenden Projektrouten unten behalten ihre eigenen HTTP-Methoden.

Erstellen Sie einen API-Schlüssel mit `account:read`, setzen Sie die Umgebungsvariable `VOICECHEAP_API_KEY` und testen Sie diese schreibgeschützte Anfrage:

```bash theme={null}
curl --request POST 'https://api.voicecheap.ai/v1/actions/account_get' \
  --header "x-api-key: $VOICECHEAP_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{}'
```

Eine abgeschlossene Aktion liefert HTTP 200 mit dem Ergebnis in `data`. Eine länger laufende Aktion liefert HTTP 202 und eine `requestId`; rufen Sie den [Anfragestatus](https://api-docs.voicecheap.ai/docs/de/api-reference/actions/requests/action-request-get.md) ab, um das Ergebnis zu erhalten. Ein Medienauftrag kann nach Abschluss der Aktionsanfrage weiterlaufen.

Öffnen Sie [alle Aktionsseiten nach Bereich](https://api-docs.voicecheap.ai/docs/de/api-reference/actions.md) oder [ermitteln Sie die für Ihren Schlüssel erlaubten Aktionen und Schemas](https://api-docs.voicecheap.ai/docs/de/api-reference/discovery/actions-list.md). Jede Seite nennt die genauen Berechtigungen, Parameter, Beispiele und Fehler.

## Inhaltstypen

* **Anfrage**: Verwenden Sie `multipart/form-data` für Datei-Uploads, `application/json` für andere Anfragen
* **Antwort**: JSON-Endpunkte geben `application/json` zurück. Transkript-Exporte können auch SRT- oder VTT-Text zurückgeben.

## Datei-Uploads und bestehende Projektrouten

> [card] [Medien transkribieren](https://api-docs.voicecheap.ai/docs/de/api-reference/transcribe.md)
>
> `POST /v1/transcribe`
>
> Transkribieren Sie eine hochgeladene Datei als JSON, SRT oder VTT.

> [card] [Projekttranskript exportieren](https://api-docs.voicecheap.ai/docs/de/api-reference/project-transcript.md)
>
> `POST /v1/projects/{projectId}/transcript`
>
> Rufen Sie originale oder übersetzte Projekttranskripte ab.

> [card] [Projekt erstellen](https://api-docs.voicecheap.ai/docs/de/api-reference/create-project.md)
>
> `POST /v1/projects`
>
> Laden Sie eine Video- oder Audiodatei hoch und starten Sie nur die Transkription.

> [card] [Übersetzung starten](https://api-docs.voicecheap.ai/docs/de/api-reference/translate.md)
>
> `POST /v1/translate`
>
> Laden Sie eine Video- oder Audiodatei hoch und starten Sie ein Übersetzungsprojekt.

> [card] [Projekt synchronisieren](https://api-docs.voicecheap.ai/docs/de/api-reference/dub-project.md)
>
> `POST /v1/projects/{projectId}/dub`
>
> Vertonen Sie ein transkribiertes Projekt mit Ihrer eigenen übersetzten SRT-Datei.

> [card] [Übersetzungsstatus abrufen](https://api-docs.voicecheap.ai/docs/de/api-reference/translation-status.md)
>
> `GET /v1/translate/{projectId}/status`
>
> Überprüfen Sie den Status eines Übersetzungsprojekts und rufen Sie die Ergebnisse ab.

> [card] [Projektdetails abrufen](https://api-docs.voicecheap.ai/docs/de/api-reference/project-details.md)
>
> `GET /v1/projects/{projectId}`
>
> Rufen Sie die Historie der übersetzten Versionen, die Historie der Lippensynchronisation und den Projektstatus ab.

> [card] [Projekt löschen](https://api-docs.voicecheap.ai/docs/de/api-reference/delete-project.md)
>
> `DELETE /v1/translate/{projectId}`
>
> Löschen Sie ein Übersetzungsprojekt und dessen Assets dauerhaft.

## Übersetzungs-Workflow

Der typische Workflow für die Übersetzung eines Videos ist:

```mermaid theme={null}
sequenceDiagram
    participant Client as Client
    participant API
    participant Processing as Verarbeitung

    Client->>API: POST /v1/translate (Datei + Optionen)
    API->>Processing: Übersetzungsauftrag einreihen
    API-->>Client: 201 (projectId)

    loop Status abfragen
        Client->>API: GET /v1/translate/{projectId}/status
        API-->>Client: status (processing/success/failed)
    end

    Note over Client: URL des übersetzten Videos herunterladen, wenn der Status "success" ist
```

## Antwortformat

Die folgenden bestehenden Datei-Upload- und Projektrouten behalten ihre jeweiligen Antwortformate.

Die Felder einer erfolgreichen Antwort hängen vom Endpunkt ab. Anfragen zum Erstellen eines Projekts oder Starten einer Synchronisation geben `success`, `message` und `projectId` zurück. Status- und Projektdetailanfragen liefern den Projektzustand; Transkriptanfragen geben JSON, SRT oder VTT zurück. Die genauen Felder stehen auf der jeweiligen Endpunktseite.

Fehler geben ein JSON-Objekt mit `code` und `message` zurück, manchmal auch mit `details`. Siehe [Fehlercodes](https://api-docs.voicecheap.ai/docs/de/api-reference/errors.md).

## HTTP-Statuscodes

| Statuscode | Beschreibung |
| - | - |
| 200 | Erfolg |
| 201 | Erstellt – Ein Projekt oder Synchronisationslauf wurde gestartet |
| 202 | Angenommen - Verfolgen Sie die asynchrone Aktion mit ihrer Anfragekennung |
| 400 | Ungültige Anfrage - Ungültige Parameter |
| 401 | Nicht autorisiert - Ungültiger oder fehlender API-Schlüssel |
| 403 | Verboten - Unzureichende Berechtigungen oder Guthaben |
| 404 | Nicht gefunden - Ressource existiert nicht |
| 409 | Konflikt – Der Projektzustand lässt die Anfrage nicht zu |
| 413 | Nutzlast zu groß – Die hochgeladene Datei überschreitet das Limit |
| 429 | Zu viele Anfragen - Ratenbegrenzung überschritten |
| 500 | Interner Serverfehler |
| 502 | Fehler beim Verarbeiten – Die Transkription konnte nicht abgeschlossen werden |
| 503 | Dienst vorübergehend nicht verfügbar - Gleiche Anfragekennung beibehalten und vor erneutem Versuch den Status prüfen |


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