Skip to main content
POST
cURL
Verwenden Sie diesen Endpoint, um Gesichter in einem Quellvideo zu identifizieren, bevor Sie einen nachgelagerten lip-sync-Workflow ausführen.

Was diese Route zurückgibt

  • Eine session_id, die das aktuelle Ergebnis der Gesichtserkennung gruppiert
  • Ein face_data-Array mit einem oder mehreren erkannten Gesichtern
  • Metadaten pro Gesicht wie face_id, Vorschaubild und Zeitbereich

Wann Sie ihn verwenden sollten

  • Senden Sie genau eine Quelle: video_id für ein abgeschlossenes Kling-Video oder video_url für eine gehostete MP4- oder MOV-Datei
  • Bevor Sie eine lip-sync-Anfrage für ein Video mit mehreren Personen im Bild erstellen
  • Wenn Sie ein bestimmtes Gesicht auswählen müssen, anstatt sich auf die automatische Auswahl zu verlassen
  • Wenn Sie die Gesichtsabdeckung in der Vorschau prüfen möchten, bevor Sie eine aufwendigere Aufgabe starten
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
video_id
string
erforderlich

Kling video id from a completed task. Send either video_id or video_url.

video_url
string

Public MP4 or MOV URL. Send either video_id or video_url.

Antwort

200 - application/json

OK

code
integer
erforderlich
message
string
erforderlich
request_id
string
erforderlich
data
object
erforderlich