Creazione di task Counterpart

Crea task video di lip-sync avanzato tramite CometAPI Kling POST /kling/v1/videos/advanced-lip-sync, inviando audio e impostazioni counterpart per generare risultati sincronizzati.

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
  }
}

Usa questo endpoint per creare un task di lip-sync avanzato dopo aver già identificato i volti nel video sorgente.

​

Prima di chiamarlo

• Inizia con Lip-Sync per ottenere session_id e i valori face_id disponibili
• Crea una o più voci face_choose che associano ogni volto a un segmento audio
• Assicurati che i campi temporali descrivano come l’audio deve allinearsi all’interno del video

​

Flusso del task

1. Identifica prima i volti

   Esegui Lip-Sync sul video sorgente e conserva il session_id restituito insieme ai valori face_id di destinazione.

2. Crea il task di lip-sync avanzato

   Invia session_id e l’array face_choose tramite questo endpoint.

3. Monitora il task generato

   Salva l’id del task restituito per i controlli di stato e il recupero del risultato finale.

Per il riferimento completo dei parametri, consulta la documentazione ufficiale di Kling.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

session_id · string · predefinito: 806556222048190514 · obbligatorio

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

face_choose · object[] · obbligatorio

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

Show child attributes

Risposta

200 - application/json

Task accepted.

code · integer · obbligatorio

message · string · obbligatorio

data · object · obbligatorio

Show child attributes