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

> Abgeschlossene Vozo-API-Videos auf YouTube veröffentlichen

Die YouTube-Export-API veröffentlicht eine abgeschlossene Vozo-Videotask in einem verbundenen YouTube-Kanal. Sie können Videos aus **Übersetzen & Synchronisieren**, Visuelle Übersetzung oder Lippensynchronisation veröffentlichen. Die API gibt eine neue **Export-Task-ID** zurück; fragen Sie die Export-Task ab, bis sie `done` oder `failed` ist.

## Bevor Sie beginnen

* Verbinden und autorisieren Sie Ihren YouTube-Kanal in Vozo. Wenn die Verbindung abgelaufen ist, autorisieren Sie sie erneut, bevor Sie einen Export erstellen.
* Sie benötigen Zugriff auf die Vozo-API, einen für Ihr Konto aktivierten YouTube-Export und einen Studio-Plan oder höher.
* Die Vozo-Quell-Task muss demselben Benutzer gehören und abgeschlossen sein. Ihre Videodatei muss noch verfügbar sein.
* Die Veröffentlichung auf YouTube unterliegt sowohl dem 24-Stunden-Exportkontingent Ihres Kontos als auch einem Systemkontingent.
* Verwenden Sie einen API-Schlüssel im Header `Authorization: Bearer <api_key>`.

## Workflow

<Steps>
  <Step title="Videokategorien abrufen">
    Rufen Sie [Kategorien auflisten](/docs/de/api_reference/endpoints/youtube_export/categories) auf, um eine für die Region Ihres verbundenen Kanals gültige `category_id` zu erhalten. Es werden nur zuweisbare Kategorien zurückgegeben.
  </Step>

  <Step title="Einen Export erstellen">
    Rufen Sie [Export-Task erstellen](/docs/de/api_reference/endpoints/youtube_export/create) mit der abgeschlossenen Quell-Task, dem Titel, der Kategorie und der Datenschutzeinstellung auf. Bewahren Sie die zurückgegebene `task_id` auf: Sie identifiziert den **YouTube-Export**, nicht die ursprüngliche Vozo-Task.
  </Step>

  <Step title="Die Export-Task abfragen">
    Rufen Sie [Export-Task abrufen](/docs/de/api_reference/endpoints/youtube_export/get) mit der Export-Task-ID auf. Sobald `status` `done` ist, verwenden Sie `studio_url`, um das Video in YouTube Studio zu öffnen. Wenn der Status `failed` ist, prüfen Sie `error_code`.
  </Step>
</Steps>

## Quell-Tasks und Modi

| `task_type`        | Unterstützter `source_mode`                      | Verhalten                                                                                                                                         |
| ------------------ | ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| `translate_dub`    | `initial_output`, `generate_new`, `use_existing` | Das ursprünglich exportierte Video veröffentlichen, das bearbeitbare Projekt erneut rendern oder einen vorhandenen Projektexport wiederverwenden. |
| `visual_translate` | `initial_output`, `generate_new`, `use_existing` | Dieselben Optionen für ein Video der Visuellen Übersetzung.                                                                                       |
| `lip_sync`         | `source_mode` weglassen                          | Veröffentlicht immer die ursprüngliche Ausgabe der abgeschlossenen Lippensynchronisation-Task.                                                    |

Für **Übersetzen & Synchronisieren** und Visuelle Übersetzung ist `source_mode` erforderlich, wenn die Quell-Task ein bearbeitbares Projekt hat. Bei einer nicht bearbeitbaren Quell-Task wird durch Weglassen `initial_output` ausgewählt. `generate_new` und `use_existing` erfordern das zugehörige bearbeitbare Projekt; `use_existing` erfordert außerdem ein bereits exportiertes Video. `initial_output` erfordert eine Videoausgabe aus der Quell-Task.

## Exportstatus

| Status       | Bedeutung                                                                                                 |
| ------------ | --------------------------------------------------------------------------------------------------------- |
| `pending`    | Export-Task akzeptiert, aber noch nicht gestartet.                                                        |
| `processing` | Veröffentlichung wird durchgeführt.                                                                       |
| `done`       | Veröffentlichung abgeschlossen; `studio_url` ist verfügbar, wenn YouTube eine Video-ID zurückgegeben hat. |
| `failed`     | Veröffentlichung fehlgeschlagen; `error_code` ist vorhanden, wenn ein Fehlergrund verfügbar ist.          |

<Note>
  Diese Endpunkte erstellen oder autorisieren keine YouTube-Verbindung. Schließen Sie diese Einrichtung in Vozo ab, bevor Sie die Export-API verwenden.
</Note>

## Häufige API-Fehler

| Code   | Bedeutung                                                         |
| ------ | ----------------------------------------------------------------- |
| `1300` | Quell- oder Export-Task wurde nicht gefunden.                     |
| `1601` | YouTube-Konto ist nicht verbunden.                                |
| `1602` | YouTube-Export ist für dieses Konto deaktiviert.                  |
| `1603` | Das YouTube-Exportkontingent des Kontos ist ausgeschöpft.         |
| `1604` | Das System-YouTube-Kontingent ist ausgeschöpft.                   |
| `1605` | Die YouTube-Verbindung erfordert eine erneute Autorisierung.      |
| `1710` | Der aktuelle Plan erfüllt die Anforderung des Studio-Plans nicht. |

Bei anderen Fehlern prüfen Sie die Felder `code`, `message` und optional `errors` in der Antwort. Eine Veröffentlichungs-Task kann auch nach ihrer Erstellung den Status `failed` erreichen; fragen Sie für diesen Fall ihren `error_code` ab.