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

| Funktion | LipSync API | Wiederverwendbare LipSync API |
| :- | :- | :- |
| Referenz-Upload | Für jede Anfrage erforderlich | Einmal hochladen, mehrfach wiederverwenden |
| Trainingsschritt | Erforderlich | Nicht erforderlich |
| Eingabe für die Generierung | Referenz ＋ Audio | Audio oder Text (Referenz wiederverwendet) |
| Generierungsgeschwindigkeit | Standard | Deutlich schneller (kein erneutes Training) |
| Kosten pro Anfrage | 5 Punkte Grundkosten ＋ 5 Punkte pro Minute | 5 Punkte pro Minute |

## Ein- und Ausgaben

### Wiederverwendbares Modell erstellen

| Feld | Werte | Anforderung | Beschreibung |
| - | - | - | - |
| `task_id` | ID des Lippensynchronisations-Jobs | Erforderlich | ID eines früheren Lippensynchronisations-API-Jobs, der mit `precision_v1` erstellt wurde. |

Ausgabe: `model_id` des wiederverwendbaren Lippensynchronisationsmodells.

### Mit einem wiederverwendbaren Modell generieren

| Feld | Werte | Anforderung | Beschreibung |
| - | - | - | - |
| `model_id` | ID des wiederverwendbaren Lippensynchronisationsmodells | Erforderlich | Gibt das zu verwendende wiederverwendbare Modell an. |
| `audio_url` | Öffentlich zugängliche Audio-URL | Bedingt; entweder `audio_url` oder `driving_text` ist erforderlich | Stellt das steuernde Audio bereit und hat Vorrang, wenn beide Felder angegeben werden. Unterstützt `.wav`, `.mp3` und `.m4a`. |
| `driving_text` | Zeichenfolge | Bedingt; entweder `audio_url` oder `driving_text` ist erforderlich | Synthetisiert die steuernde Sprache mit der aus der ursprünglichen Referenz geklonten Stimme. |
| `callback_url` | URL | Optional | Empfängt bei jeder Änderung des Jobstatus einen Webhook. |

Ausgabe: URL des lippensynchronisierten Videos.

## Funktionsweise

<Steps>
  <Step title="Erstellen Sie ein wiederverwendbares Lippensynchronisationsmodell">
    Erstellen Sie ein wiederverwendbares Modell aus einem kompatiblen früheren Lippensynchronisations-Job.
  </Step>

  <Step title="Bereiten Sie das steuernde Audio oder den Text vor">
    Hosten Sie Ihr Audio unter einer öffentlich zugänglichen URL oder geben Sie Text an, um Sprache mit der geklonten Stimme zu synthetisieren.
  </Step>

  <Step title="Senden Sie eine Generierungsanfrage">
    Geben Sie die erforderlichen Eingaben und alle optionalen Einstellungen für den Job an.
  </Step>

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

  <Step title="Laden Sie das Video herunter">
    Rufen Sie das fertige Sprechende Foto oder lippensynchronisierte Video über die angegebene URL ab.
  </Step>
</Steps>

## Nutzungseinschränkungen:

* Das standardmäßige Limit für die gleichzeitige Ausführung beträgt 10 Jobs. Dieses Limit wird von allen Mitgliedern eines Teams gemeinsam genutzt. Weitere Informationen finden Sie unter [Gleichzeitige Ausführungslimits](/docs/de/api_reference/get_started#gleichzeitige-ausführungslimits).
* Geschätzte Wartezeit: 1–120 Minuten, abhängig von der Systemauslastung.
* Verarbeitungszeit: \~10 Minuten.

<Note>
  Wenn ein Video oder Foto mehrere Gesichter enthält, wird nur das größte erkannte Gesicht lippensynchronisiert.
</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

* Für die Nutzung dieser API ist der Studio-Plan oder höher erforderlich. | Code | Beschreibung | | --- | --- | | 999 | Fehler beim Herunterladen der Datei. | | 20611 | Video löst Flussbeschränkung aus. |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.