Skip to main content
POST
cURL
Usa questo endpoint per applicare una delle scene di effetto preimpostate di Kling e trasformare gli asset di input in un nuovo breve video.

Scegli una scena di effetto

  • Gli effetti con immagine singola usano effect_scene insieme a input.image e input.duration
  • Gli effetti di interazione tra due persone usano effect_scene insieme a input.images con esattamente due immagini
  • Le immagini di input devono soddisfare i requisiti in pixel di Kling; le miniature troppo piccole vengono rifiutate dal task di generazione
  • La struttura esatta degli asset dipende dall’effetto selezionato, ma la richiesta racchiude sempre le impostazioni dell’effetto all’interno di input
  • Usa una scena di effetto che sia attualmente disponibile in Kling; CometAPI rifiuta valori effect_scene sconosciuti
  • Evita di fare affidamento su un elenco enum pubblico fisso; la disponibilità degli effetti cambia in base alla track del modello e alla famiglia di scene

Flusso del task

1

Invia la richiesta dell'effetto

Invia effect_scene insieme all’oggetto input corrispondente e salva il task id restituito.
2

Interroga il task

Continua con Ottenere un task Kling finché il processo dell’effetto non termina.
3

Conserva l'asset finale

Scarica o rispecchia il video con effetto completato se hai bisogno di una conservazione stabile.
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
effect_scene
string
obbligatorio

Kling preset effect scene. Single-image effects use input.image; two-person interaction effects use input.images with exactly two images.

input
Single-image effect input · object
obbligatorio

Effect-specific input payload. Single-image scenes require image and duration; two-person interaction scenes require exactly two images and duration.

callback_url
string

Webhook URL for task status notifications. The server sends a callback when the task status changes.

external_task_id
string

Optional user-defined task ID for your own tracking. Does not replace the system-generated task ID. Must be unique per account.

Risposta

200 - application/json

Task accepted.

code
integer
obbligatorio

Error code; specific error code definition

message
string
obbligatorio

Error message

data
object
obbligatorio