> ## Documentation Index
> Fetch the complete documentation index at: https://www.vozo.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Überblick

> Visuelle Übersetzung API

## Ein- & Ausgaben

Eingabe:

* video\_url
* Quellsprache & Zielsprache
* \[optional] glossary\_ids
* \[optional] user\_prompt
* \[optional] project\_mode

Ausgabe:

* übersetzte video\_url
* project\_url, wenn `project_mode` auf `editable` gesetzt ist

## So funktioniert es

<Steps>
  <Step title="Hosten Sie Ihr Video unter einer öffentlich zugänglichen URL">
    Laden Sie Ihr Eingabevideo hoch, damit unsere Server darauf zugreifen können. Das Video darf nicht länger als 20 Minuten sein.
  </Step>

  <Step title="Senden Sie eine Anfrage für visuelle Übersetzung">
    Geben Sie die Sprachcodes für Quell- und Zielsprache sowie optional Glossar-IDs oder Prompt-Anweisungen für Terminologie und Stil an.
  </Step>

  <Step title="Warten oder Status abfragen">
    Verwenden Sie Ihren Webhook-Callback oder fragen Sie die API mit der zurückgegebenen Aufgaben-ID ab, bis die Verarbeitung abgeschlossen ist.
  </Step>

  <Step title="Laden Sie das übersetzte Video herunter">
    Wenn der Auftrag abgeschlossen ist, rufen Sie das übersetzte Video über `video_url` ab. Wenn Sie ein bearbeitbares Projekt erstellt haben, öffnen Sie `project_url`, um es im Web-Dashboard zu prüfen oder zu bearbeiten.
  </Step>
</Steps>

## Nutzungsbeschränkungen

* Nur Benutzer, die API-Schlüssel erstellen können, dürfen diese API verwenden.
* Der Studio-Plan ist erforderlich; Benutzer ohne Studio sind nicht zugelassen.
* Die Eingabe muss eine Videodatei sein. Ein Export nur als Audio wird nicht unterstützt.
* Die maximal unterstützte Eingabedauer beträgt 20 Minuten.
* Die automatische Erkennung der Quellsprache wird nicht unterstützt. Übergeben Sie ausdrücklich einen unterstützten Sprachcode für die Quellsprache.
* Der Sprachcode folgt dem IETF-BCP-47-Stil, z. B. `en-US`, `zh-CN`, `zh-CN-GUANGXI`.

## API-Fehlercodes

| Code | Beschreibung                                                            |
| ---- | ----------------------------------------------------------------------- |
| 5    | Ungültige Anfrageparameter.                                             |
| 7    | Keine Berechtigung für die Anfrage.                                     |
| 104  | Unzureichendes Guthaben.                                                |
| 814  | Ihr Konto ist kein Mitglied und darf die API nicht aufrufen.            |
| 1000 | Interner Serverfehler.                                                  |
| 1301 | Callback-Challenge fehlgeschlagen.                                      |
| 1302 | API-Schlüssel wurde widerrufen.                                         |
| 1304 | API-Schlüssel hat die maximale Anzahl gleichzeitiger Anfragen erreicht. |
| 1503 | Ihr Konto ist nicht berechtigt, die API aufzurufen.                     |
| 1305 | Nur der Studio-Plan ist zulässig.                                       |

## Auftrags-Fehlercodes

| Code  | Beschreibung                                              |
| ----- | --------------------------------------------------------- |
| 40002 | Hochgeladene Datei enthält keinen Videostream.            |
| 40010 | Transkodierung fehlgeschlagen.                            |
| 40050 | Übersetzung fehlgeschlagen.                               |
| 40020 | OCR-Extraktion fehlgeschlagen.                            |
| 40032 | Keine gültigen Callouts im Video.                         |
| 40040 | Zuordnung von OCR zu Callouts fehlgeschlagen.             |
| 40041 | Kein Callout konnte OCR zugeordnet werden.                |
| 40060 | Verfeinerung der Callouts fehlgeschlagen.                 |
| 40061 | Stil konnte bei der Verfeinerung nicht extrahiert werden. |
| 40080 | Generierung des Vorschaubildvideos fehlgeschlagen.        |