> ## 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 basiert auf REST-Prinzipien. Sie verwendet Standard-HTTP-Methoden, gibt JSON-kodierte Antworten zurück und nutzt Standard-HTTP-Antwortcodes.

## Basis-URL

Alle API-Anfragen sollten an folgende Adresse gerichtet werden:

```
https://api.voicecheap.ai
```

## Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel, der im `x-api-key`-Header übergeben wird. Weitere Details finden Sie auf der Seite [Authentifizierung](/docs/de/authentication).

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

## Verfügbare Endpunkte

<CardGroup cols={2}>
  <Card title="Medien transkribieren" icon="captions" href="/docs/de/api-reference/transcribe">
    `POST /v1/transcribe`

    Transkribieren Sie eine hochgeladene Datei als JSON, SRT oder VTT.
  </Card>

  <Card title="Projekttranskript exportieren" icon="file-lines" href="/docs/de/api-reference/project-transcript">
    `POST /v1/projects/{projectId}/transcript`

    Rufen Sie originale oder übersetzte Projekttranskripte ab.
  </Card>

  <Card title="Übersetzung starten" icon="play" href="/docs/de/api-reference/translate">
    `POST /v1/translate`

    Laden Sie eine Video- oder Audiodatei hoch und starten Sie ein Übersetzungsprojekt.
  </Card>

  <Card title="Übersetzungsstatus abrufen" icon="magnifying-glass" href="/docs/de/api-reference/translation-status">
    `GET /v1/translate/{projectId}/status`

    Überprüfen Sie den Status eines Übersetzungsprojekts und rufen Sie die Ergebnisse ab.
  </Card>

  <Card title="Projektdetails abrufen" icon="list-tree" href="/docs/de/api-reference/project-details">
    `GET /v1/projects/{projectId}`

    Rufen Sie die Historie der übersetzten Versionen, die Historie der Lippensynchronisation und den Projektstatus ab.
  </Card>

  <Card title="Projekt löschen" icon="trash" href="/docs/de/api-reference/delete-project">
    `DELETE /v1/translate/{projectId}`

    Löschen Sie ein Übersetzungsprojekt und dessen Assets dauerhaft.
  </Card>
</CardGroup>

## Übersetzungs-Workflow

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

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

    Client->>API: POST /v1/translate (file + options)
    API->>Processing: Queue translation job
    API-->>Client: 200 OK (projectId)

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

    Note over Client: Download translated video URL when status is "success"
```

## Antwortformat

Alle erfolgreichen Antworten folgen dieser allgemeinen Struktur:

```json theme={null}
{
  "success": true,
  "message": "Description of the result"
  // Additional fields specific to the endpoint
}
```

Fehlerantworten folgen dieser Struktur:

```json theme={null}
{
  "code": "ERROR_CODE",
  "message": "Human-readable error description"
}
```

## HTTP-Statuscodes

| Statuscode | Beschreibung                                                |
| ---------- | ----------------------------------------------------------- |
| 200        | Erfolg                                                      |
| 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                  |
| 429        | Zu viele Anfragen - Ratenbegrenzung überschritten           |
| 500        | Interner Serverfehler                                       |