Skip to main content
Übersetzungsstatus abrufen

Übersetzungsstatus abrufen

Rufen Sie den aktuellen Status eines Übersetzungsprojekts ab. Verwenden Sie diesen Endpunkt, um den Fortschritt abzufragen und die URL des übersetzten Videos zu erhalten, sobald die Verarbeitung abgeschlossen ist.

Anfrage

string
erforderlich
Ihr VoiceCheap API-Schlüssel. Erhalten Sie einen unter app.voicecheap.ai/page-api.

Pfadparameter

string
erforderlich
Die eindeutige Kennung des Übersetzungsprojekts, die vom Start Translation-Endpunkt zurückgegeben wird.

Antwort

Die Antwortstruktur variiert je nach Übersetzungsstatus.

Allgemeine Felder

string
erforderlich
Die eindeutige Kennung des Projekts
string
erforderlich
Der Name des Projekts
string
erforderlich
URL zur ursprünglichen hochgeladenen Video-/Audiodatei
string
erforderlich
Die erkannte oder angegebene Originalsprache
string
erforderlich
Die Zielsprache für die Übersetzung
number
erforderlich
Dauer des Inhalts in Sekunden
number
erforderlich
Unix-Zeitstempel, zu dem das Projekt erstellt wurde
string
erforderlich
API-Workflow, der das Projekt erstellt hat: translation oder transcription.
string
erforderlich
Status der Quelltranskription: processing, success oder failed. Dieses Signal ist unabhängig vom Abschluss der Synchronisation.
object
erforderlich
Verfügbare normalisierte Transkripte.
string
Kennung der Übersetzungsarbeit für die aktuell gemeldete übersetzte Version.
string
Kennung der übersetzten Version für die aktuell gemeldete übersetzte Version.
string
Aktueller Projektschritt. Während der Erstellung oder Transkription spiegelt dies den aktiven Erstellungsschritt wider. Beispiele sind downloading_content, content_validation und transcription_processing. Sobald die Synchronisation beginnt, kann sie zu einem aktiven Synchronisationsschritt wie smart_sync oder audio_assembling wechseln. status: processing lässt sich nicht mit actualProgressStep: done kombinieren.
number
Ungefährer Fortschrittsprozentsatz für die Projekterstellung/-transkription (0-100)
string
Aktueller Synchronisationsschritt für die Zielsprache (z. B. smart_sync, audio_enhancement, video_upload)
number
Ungefährer Fortschrittsprozentsatz für die Synchronisation (0-100)
string
erforderlich
Aktueller Status der Übersetzung: processing, success oder failed

Lip Sync Felder

Wenn eine Lippensynchronisation angefordert wurde, enthält die Antwort ein zusätzliches lipSync-Objekt:
object
Status und Details der Lippensynchronisation (nur vorhanden, wenn eine Lippensynchronisation angefordert wurde)
Wenn eine Lippensynchronisation angefordert wird, bleibt die Übersetzung in processing, bis lipSync.status COMPLETED ist. Wenn die Lippensynchronisation fehlschlägt, ändert sich der Status zu failed und error.code ist LIPSYNC_FAILED. Wenn die Lippensynchronisation erfolgreich ist, lesen Sie das lippensynchronisierte Asset von lipSync.videoUrl; translatedVideoUrl ist die übersetzte Videoausgabe vor dem Overlay der Lippensynchronisation.
Verwenden Sie GET /v1/projects/{projectId}, wenn Sie den vollständigen Verlauf der übersetzten Version oder den vollständigen Verlauf der Lippensynchronisation benötigen.

Felder für erfolgreiche Antworten

Für Übersetzungs-Workflows sind die folgenden Felder enthalten, wenn status success ist. Ein Workflow, der nur aus Transkription besteht, erreicht success ohne übersetzte Medienfelder.
string
URL zum Herunterladen der übersetzten Videodatei
string
URL zum separaten Herunterladen der übersetzten Audiodatei

Felder für fehlerhafte Antworten

Wenn status failed ist, ist das folgende zusätzliche Feld enthalten:
object
Fehlerdetails

Beispiele

Antwortbeispiele

Verarbeitungsstatus

Verarbeitungsstatus (Lip Sync angefordert)

Erfolgsstatus

Erfolgsstatus (Lip Sync abgeschlossen)

Fehlerstatus

Best Practices für das Polling

Empfohlenes Polling-Intervall: 10-30 SekundenDie Übersetzungszeit variiert je nach Videolänge und Komplexität. Rechnen Sie bei einem typischen 2-Minuten-Video mit 2-5 Minuten Verarbeitungszeit.
Ratenbegrenzung: 30 Anfragen pro MinuteVermeiden Sie es, häufiger als alle 2 Sekunden abzufragen, um innerhalb der Ratenbegrenzungen zu bleiben.

Fehler