Skip to main content
POST
cURL
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

Inizializzare la sessione di editing

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

Creare l'area di selezione

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

Inviare l'attività finale

Invia il session_id, edit_mode, il prompt finale e qualsiasi impostazione di generazione opzionale 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 della regione sia corretta prima di consumare una chiamata di generazione
  • Esegui le chiamate successive alla selezione sullo stesso account e con l’esatto session_id restituito dall’inizializzazione
  • Imposta edit_mode su addition, swap o removal
  • Fornisci image_list per addition e swap; ometti image_list per removal
  • Invia duration come stringa, ad esempio "5" o "10"; gli esempi passano esplicitamente "5"
  • Considera questa route come il passaggio finale di generazione, non come il passaggio di configurazione
  • Aggiungi image_list, negative_prompt, mode, duration, callback_url o external_task_id solo quando il flusso di modifica ne ha bisogno
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
obbligatorio

Selection session id returned by init-selection. Follow-up calls must use the same account and exact session id.

edit_mode
enum<string>
obbligatorio

Editing operation for the selected video region. Use addition to add an element, swap to replace a selected element, or removal to remove it.

Opzioni disponibili:
addition,
swap,
removal
prompt
string
obbligatorio

Instruction describing the desired edit. Reference the source video as <<<video_1>>> and any reference image as <<<image_1>>>.

model_name
enum<string>
predefinito:kling-v1-6

Kling model variant for the final edit task. Omit to use kling-v1-6.

Opzioni disponibili:
kling-v1-6
image_list
object[]

Image references used by addition and swap tasks. Omit this field for removal tasks.

Minimum array length: 1
negative_prompt
string

Elements to avoid in the edited result.

mode
enum<string>

Generation mode. Use std or pro.

Opzioni disponibili:
std,
pro
duration
string

Requested output duration in seconds.

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.

Risposta

200 - application/json

Task accepted.

code
integer
obbligatorio
message
string
obbligatorio
data
object
obbligatorio