Skip to main content

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:

Authentifizierung

Alle Anfragen erfordern einen API-Schlüssel, der im x-api-key-Header übergeben wird. Weitere Details finden Sie auf der Seite Authentifizierung.

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

Medien transkribieren

POST /v1/transcribeTranskribieren Sie eine hochgeladene Datei als JSON, SRT oder VTT.

Projekttranskript exportieren

POST /v1/projects/{projectId}/transcriptRufen Sie originale oder übersetzte Projekttranskripte ab.

Übersetzung starten

POST /v1/translateLaden Sie eine Video- oder Audiodatei hoch und starten Sie ein Übersetzungsprojekt.

Übersetzungsstatus abrufen

GET /v1/translate/{projectId}/statusÜberprüfen Sie den Status eines Übersetzungsprojekts und rufen Sie die Ergebnisse ab.

Projektdetails abrufen

GET /v1/projects/{projectId}Rufen Sie die Historie der übersetzten Versionen, die Historie der Lippensynchronisation und den Projektstatus ab.

Projekt löschen

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:

Antwortformat

Alle erfolgreichen Antworten folgen dieser allgemeinen Struktur:
Fehlerantworten folgen dieser Struktur:

HTTP-Statuscodes