Skip to main content
POST
cURL
Verwenden Sie diesen Endpunkt, um eine erweiterte Lip-Sync-Aufgabe zu erstellen, nachdem Sie bereits Gesichter im Quellvideo identifiziert haben.

Bevor Sie ihn aufrufen

  • Beginnen Sie mit Lip-Sync, um die session_id und die verfügbaren face_id-Werte zu erhalten
  • Erstellen Sie einen oder mehrere face_choose-Einträge, die jedes Gesicht einem Audiosegment zuordnen
  • Verwenden Sie audio_id für Audio, das von einer vorherigen Aufgabe erzeugt wurde, oder sound_file für eine gehostete Audiodatei
  • Senden Sie Zeitfelder in Millisekunden. Zum Beispiel wählen sound_start_time: "0" und sound_end_time: "2000" die ersten 2 Sekunden aus.
  • Stellen Sie sicher, dass das zugeschnittene Audiosegment mindestens 2000 ms lang ist und die Dauer des Quellaudios nicht überschreitet
  • Setzen Sie callback_url oder external_task_id nur, wenn Sie eine Webhook-Zustellung oder Ihre eigene Tracking-ID benötigen

Aufgabenablauf

1

Zuerst Gesichter identifizieren

Führen Sie Lip-Sync für das Quellvideo aus und behalten Sie die zurückgegebene session_id sowie die Ziel-face_id-Werte.
2

Die erweiterte Lip-Sync-Aufgabe erstellen

Übermitteln Sie session_id und das Array face_choose über diesen Endpunkt.
3

Die erzeugte Aufgabe verfolgen

Speichern Sie die zurückgegebene Task-ID für Statusprüfungen und das Abrufen des endgültigen Ergebnisses.
Die vollständige Parameterreferenz finden Sie in der offiziellen Kling-Dokumentation.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Body

application/json
session_id
string
erforderlich

Session id returned by identify-face.

face_choose
object[]
erforderlich

One or more face/audio mappings to synthesize.

Minimum array length: 1
callback_url
string

Webhook URL to receive task status updates.

external_task_id
string

Custom task id for your own tracking. Must be unique per account.

Antwort

200 - application/json

Task accepted.

code
integer
erforderlich
message
string
erforderlich
data
object
erforderlich