Saltar para o conteúdo principal
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
      }
    ]
  }
}
Use este endpoint para identificar rostos em um vídeo de origem antes de executar um fluxo de trabalho posterior de sincronização labial.

​
O que esta rota retorna

  • Um session_id que agrupa o resultado atual da detecção de rostos
  • Um array face_data com um ou mais rostos detectados
  • Metadados por rosto, como face_id, imagem de visualização e intervalo de tempo

​
Quando usar

  • Antes de montar uma solicitação de sincronização labial para um vídeo com várias pessoas na tela
  • Quando você precisa escolher um rosto específico em vez de depender da seleção automática
  • Quando você quer visualizar a cobertura dos rostos antes de iniciar uma tarefa mais cara
Para a referência completa de parâmetros, consulte a documentação oficial do Kling.

Autorizações

​
Authorization
string
header
obrigatório

Bearer token authentication. Use your CometAPI key.

Corpo

application/json
​
video_url
string
padrão:example
obrigatório

Public URL of the video to analyze for face identification.

Resposta

200 - application/json

OK

​
code
integer
obrigatório
​
message
string
obrigatório
​
request_id
string
obrigatório
​
data
object
obrigatório