Skip to main content
POST
cURL
Use este endpoint para criar uma tarefa avançada de lip-sync depois de já ter identificado rostos no vídeo de origem.

Antes de chamá-lo

  • Comece com Lip-Sync para obter o session_id e os valores face_id disponíveis
  • Crie uma ou mais entradas face_choose que mapeiem cada rosto para um segmento de áudio
  • Use audio_id para áudio produzido por uma tarefa anterior, ou sound_file para um arquivo de áudio hospedado
  • Envie os campos de tempo em milissegundos. Por exemplo, sound_start_time: "0" e sound_end_time: "2000" selecionam os primeiros 2 segundos.
  • Certifique-se de que o segmento de áudio recortado tenha pelo menos 2000 ms e não exceda a duração do áudio de origem
  • Defina callback_url ou external_task_id apenas quando precisar de entrega por webhook ou do seu próprio id de rastreamento

Fluxo da tarefa

1

Identifique os rostos primeiro

Execute Lip-Sync no vídeo de origem e guarde o session_id retornado junto com os valores face_id de destino.
2

Crie a tarefa avançada de lip-sync

Envie session_id e o array face_choose por meio deste endpoint.
3

Acompanhe a tarefa gerada

Salve o id da tarefa retornada para verificações de status e recuperação do resultado final.
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
session_id
string
obrigatório

Session id returned by identify-face.

face_choose
object[]
obrigatório

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.

Resposta

200 - application/json

Task accepted.

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