Zum Hauptinhalt springen
POST
/
kling
/
v1
/
videos
/
identify-face
Lip-Sync
curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/identify-face \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "video_url": "https://replicate.delivery/xezq/lZfr3rskBEVLDCytear4lUo92fOpAcoblFWzk6e06WEnC3PTB/tmpny051d_c.mp4"
}
'
{
  "code": 123,
  "message": "<string>",
  "request_id": "<string>",
  "data": {
    "session_id": "<string>",
    "face_data": [
      {
        "face_id": "<string>",
        "face_image": "<string>",
        "start_time": 123,
        "end_time": 123
      }
    ]
  }
}
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 sie verwenden sollten

  • 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, statt sich auf die automatische Auswahl zu verlassen
  • Wenn Sie die Gesichtsabdeckung in der Vorschau prüfen möchten, bevor Sie eine teurere 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_url
string
Standard:example
erforderlich

Public URL of the video to analyze for face identification.

Antwort

200 - application/json

OK

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