Skip to main content
POST
Fragen Sie den Fortschritt von Transkription, Übersetzung und Lippensynchronisation ab und rufen Sie die URLs abgeschlossener Ausgaben ab.

Authentifizierung und Berechtigungen

string
erforderlich
Senden Sie einen VoiceCheap-API-Schlüssel in diesem Header. Authorization: Bearer mit demselben API-Schlüssel wird ebenfalls unterstützt. OAuth-Zugriffstoken werden nur von MCP akzeptiert, nicht von diesem REST-Endpunkt.
Erforderliche Berechtigungen: projects:read. Ein aktives kostenpflichtiges Abonnement ist erforderlich. Berechtigungen ändern weder Teamrollen noch Ressourceneigentum, Medienguthaben oder Tariflimits.

Parameter

string
erforderlich
Textwert.Mindestlänge: 1. Höchstlänge: 200. Muster: ^[^/\\]+$.
Das folgende JSON Schema enthält die exakten Feldnamen, verschachtelten Typen, Standardwerte, Grenzen und akzeptierten Werte aus der Discovery. Zusätzliche feldübergreifende Regeln finden Sie in den Hinweisen zur Operation.

Anfragebeispiele

Ersetzen Sie die beispielhaften Ressourcenkennungen und Medienschlüssel durch Werte, die für Ihr Konto zurückgegeben wurden. Behalten Sie bei Wiederholungen derselben Mutation dieselbe Anfragekennung bei.

Antwort

Eine erfolgreiche erste Ausführung gibt HTTP 200 mit dem Ergebnis der Operation unter data zurück. Bei einer Wiederholung kann stattdessen der gespeicherte Anfragestatus zurückgegeben werden. Das Beispiel zeigt eine unterstützte Antwort, nicht alle optionalen Felder. Gibt den Verarbeitungsfortschritt und fertige Ausgabe-URLs ohne eingebettete Transkripte zurück.

Ergebnisfelder

Hinweise zur Operation

  • Verwenden Sie diese Aktion, um projects_create, translations_create, translations_start, translations_dub und lipsync_create regelmäßig abzufragen. Rufen Sie Transkripte separat mit transcripts_get ab.
  • Dieser authentifizierte, ratenbegrenzte Statusabruf verbraucht kein monatliches Aktionsaufrufkontingent.
  • Bei Übersetzungen folgt dies der zuletzt erstellten Sprachfassung und ihrer letzten Version. Rufen Sie projects_get oder translations_list ab, um den vollständigen mehrsprachigen Status zu erhalten.
  • Ein reines Transkriptionsprojekt ist erfolgreich, sobald die Transkription abgeschlossen ist. Eine abgeschlossene synchronisierte Ausgabe kann im Status processing bleiben, während die Lippensynchronisation aktiv ist, oder im Status failed, wenn ihre letzte Lippensynchronisation fehlgeschlagen ist.
  • Der Handler entfernt transcripts immer aus dem zugrunde liegenden Statusergebnis. Es enthält keine Abschlussfelder für dynamische Untertitel; fragen Sie dafür projects_get ab.
  • Gespeicherte Fehler liefern VoiceCheap-Fehlercodes und feste Meldungen. Nutzen Sie den Code und den aktuellen Ressourcenstatus, um über die Fehlerbehebung zu entscheiden.

Nutzung

Diese Status- oder Nutzungsabfrage verbraucht keinen monatlichen API/MCP-Aufruf. Authentifizierung, kostenpflichtiger Zugang, Eigentumsprüfung und Ratenlimits gelten weiterhin.

Fehler