Skip to main content
POST
cURL
Use este endpoint para identificar rostos em um vídeo de origem antes de executar um fluxo de lip-sync subsequente.

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 pré-visualização e intervalo de tempo

Quando usá-lo

  • Envie exatamente uma origem: video_id para um vídeo Kling concluído, ou video_url para um MP4 ou MOV hospedado
  • Antes de montar uma solicitação de lip-sync 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 facial antes de iniciar uma tarefa mais cara
Para a referência completa dos 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_id
string
obrigatório

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.

Resposta

200 - application/json

OK

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