Criação de Tarefa de Counterpart

Crie tarefas avançadas de sincronização labial de vídeo via CometAPI Kling POST /kling/v1/videos/advanced-lip-sync, envie áudio e configurações de counterpart para gerar resultados sincronizados.

POST /kling/v1/videos/advanced-lip-sync

Create an advanced Kling lip-sync task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/advanced-lip-sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "806556222048190514",
  "face_choose": [
    {
      "face_id": "0",
      "sound_file": "https://cdn1.suno.ai/e5c97078-3260-4354-a3a6-1d7249262a48.mp3",
      "sound_start_time": "1200",
      "sound_end_time": "5000",
      "sound_insert_time": "0"
    }
  ]
}
'

200

{
  "code": 123,
  "message": "<string>",
  "data": {
    "task_id": "<string>",
    "task_status": "<string>",
    "created_at": 123,
    "updated_at": 123
  }
}

Use este endpoint para criar uma tarefa avançada de sincronização labial depois de já ter identificado os 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
• Monte uma ou mais entradas face_choose que associem cada rosto a um segmento de áudio
• Certifique-se de que os campos de tempo descrevam como o áudio deve ser alinhado dentro do vídeo

​

Fluxo da tarefa

1. Identifique os rostos primeiro

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

2. Crie a tarefa avançada de sincronização labial

   Envie session_id e o array face_choose por meio deste endpoint.

3. Acompanhe a tarefa gerada

   Salve o id da tarefa retornado para verificações de status e recuperação do resultado final.

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

session_id · string · padrão: 806556222048190514 · obrigatório

Session id returned by the face identification (lip-sync) endpoint.

face_choose · object[] · obrigatório

Face-to-audio mappings. Each entry connects a detected face to an audio segment for lip-sync.

Show child attributes

Resposta

200 - application/json

Task accepted.

code · integer · obrigatório

message · string · obrigatório

data · object · obrigatório

Show child attributes