Crea attività

Crea un’attività di editing video multimodale Kling tramite CometAPI: POST /kling/v1/videos/multi-elements per combinare più elementi e generare video in modo asincrono.

POST /kling/v1/videos/multi-elements

Create a Kling multimodal edit task

cURL

curl --request POST \
  --url https://api.cometapi.com/kling/v1/videos/multi-elements \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "session_id": "784914037360041984",
  "edit_mode": "replace",
  "prompt": "Replace the selected object with a red paper boat."
}
'

200

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

Usa questo endpoint per inviare il job finale di editing video multimodale dopo che la sessione e le selezioni sono pronte.

​

Flusso di lavoro completo

1. Inizializza la sessione di editing

   Inizia con Initialize Video for Editing per ottenere il session_id della clip che vuoi modificare.

2. Costruisci l'area di selezione

   Usa Add Video Selection e, quando necessario, Preview Selected Video Area per affinare l’area di modifica.

3. Invia l'attività finale

   Invia session_id, edit_mode e il prompt finale tramite questo endpoint, quindi salva l’id dell’attività restituito per i controlli di stato.

​

Prima di chiamarlo

• Assicurati che la sessione di selezione sia già inizializzata
• Conferma che la selezione dell’area sia corretta prima di consumare una chiamata di generazione
• Considera questa route come il passaggio finale di generazione, non quello di configurazione

Per il riferimento completo dei parametri, consulta la documentazione dell’API Kling.

Autorizzazioni

Authorization · string · header · obbligatorio

Bearer token authentication. Use your CometAPI key.

Corpo

application/json

session_id · string · predefinito: 784914037360041984 · obbligatorio

Session id returned by the video initialization endpoint.

edit_mode · string · predefinito: replace · obbligatorio

Editing operation to apply. Options: replace, remove.

prompt · string · predefinito: Replace the selected object with a red paper boat. · obbligatorio

Text prompt describing the desired edit for the selected region.

Risposta

200 - application/json

Task accepted.

code · integer · obbligatorio

message · string · obbligatorio

data · object · obbligatorio

Show child attributes