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

> Erstellen von LipSync oder Sprechenden Fotos mit wiederverwendbarem LipSync-Modell

## Warum die Verwendung der wiederverwendbaren LipSync-API?

Die wiederverwendbare LipSync-API ist eine optimierte Version unserer LipSync-API, die für Entwickler konzipiert wurde, die häufig lip-synchrone Videos mit demselben visuellen Referenzbild erzeugen.

### Was ist anders?

| Feature                     | LipSync API                          | Wiederverwendbare LipSync-API              |
| :-------------------------- | :----------------------------------- | :----------------------------------------- |
| Referenz hochladen          | Erforderlich für jede Anfrage        | Einmal hochladen, mehrfach wiederverwenden |
| Trainingsschritt            | Erforderlich                         | Nicht erforderlich                         |
| Eingabe für die Generierung | Referenz + Audio                     | Nur Audio (Referenz wird wiederverwendet)  |
| Generierungsgeschwindigkeit | Standard                             | Viel schneller (kein Retraining)           |
| Kosten pro Anfrage          | 5 Punkte Basis + 5 Punkte pro Minute | 5 Punkte pro Minute                        |

## Funktionsweise

<Steps>
  <Step title="Modell mit der ID der vorherigen Aufgabe erstellen">
    Erstellen Sie ein wiederverwendbares LipSync-Modell mit der ID der vorherigen Aufgabe aus der LipSync-API im Präzisionsmodus.
  </Step>

  <Step title="Hosten Sie Ihre Audio-Ressourcen unter einer öffentlich zugänglichen URL">
    Laden Sie Ihre Audiodatei hoch, damit unsere Server sie abrufen können.
  </Step>

  <Step title="Senden Sie eine API-Anfrage mit den entsprechenden Parametern">
    Beziehen Sie sich auf Ihre gehosteten Assets und geben Sie den gewünschten Modus an (Standard oder Präzision).
  </Step>

  <Step title="Warten oder den Status abfragen">
    Verwenden Sie unseren Webhook-Callback oder polken Sie die API mit Ihrer Job-ID, bis die Verarbeitung abgeschlossen ist.
  </Step>

  <Step title="Videoausgabe herunterladen">
    Holen Sie sich das fertige sprechende Foto oder das lip-synchronisierte Video von der bereitgestellten URL.
  </Step>
</Steps>

## Nutzungseinschränkungen:

* Sie können bis zu 10 gleichzeitige Aufgaben (einschließlich wartender Anfragen) haben.
* Geschätzte Wartezeit: 1–120 Minuten, abhängig von der Systemlast.
* Verarbeitungszeit: \~10 Minuten.

<Note>
  Wenn ein Video oder Foto mehrere Gesichter enthält, wird nur das größte erkannte Gesicht lip-synchronisiert.
</Note>

## Modell-Ablaufpolitik

Modelle, die über die Modell-Erstellungs-API erstellt wurden, haben einen automatischen Ablaufmechanismus basierend auf der Aktivität.

### Regeln

1. Standardablaufzeit: Jedes wiederverwendbare Lipsync-Modell bleibt 3 Monate ab seinem Erstellungsdatum oder der letzten Nutzung aktiv.
2. Automatische Verlängerung: Jedes Mal, wenn das wiederverwendbare Lipsync-Modell verwendet wird (z. B. in einer wiederverwendbaren Lipsync-API-Anfrage aufgerufen), wird sein Ablaufdatum von diesem Zeitpunkt an um weitere 3 Monate verlängert.
3. Ablauf: Wenn ein wiederverwendbares Lipsync-Modell 3 aufeinanderfolgende Monate nicht verwendet wird, läuft es automatisch ab und kann dauerhaft gelöscht werden.
4. Reaktivierung: Abgelaufene wiederverwendbare Lipsync-Modelle können nicht reaktiviert werden. Um die gleiche Konfiguration weiterhin zu verwenden, müssen Sie den Lipsync-Job erneut einreichen und das wiederverwendbare Lipsync-Modell über die API neu erstellen.

## API-Fehlercodes

| Code | Beschreibung                                                                                              |
| ---- | --------------------------------------------------------------------------------------------------------- |
| 5    | Ungültige Anfrageparameter.                                                                               |
| 7    | Keine Berechtigung zur Anfrage.                                                                           |
| 104  | Unzureichende Credits.                                                                                    |
| 814  | Ihr Konto ist kein Mitglied und darf die API nicht aufrufen.                                              |
| 1000 | Interner Serverfehler.                                                                                    |
| 1301 | Callback-Herausforderung fehlgeschlagen.                                                                  |
| 1302 | API-Schlüssel wurde widerrufen.                                                                           |
| 1304 | API-Schlüssel hat die maximale Anzahl gleichzeitiger Anfragen erreicht.                                   |
| 1502 | Ihr Audiotreiber ist entweder ungültig oder kann nicht heruntergeladen werden.                            |
| 1503 | Ihr Konto ist nicht autorisiert, die API aufzurufen.                                                      |
| 1504 | Die Erstellung von Aufgaben wird im Standardmodus oder für Aufgaben früherer Versionen nicht unterstützt. |
| 1305 | Nur der Studio-Plan ist erlaubt.                                                                          |
| 1506 | Modell ist abgelaufen.                                                                                    |

## Job-Fehlercodes

| Code  | Beschreibung                         |
| ----- | ------------------------------------ |
| 999   | Fehler beim Herunterladen der Datei. |
| 20611 | Video löst Flussbeschränkung aus.    |