Skip to main content
POST
cURL
Bruk dette endepunktet til å bruke en av Klings forhåndsinnstilte effektscener og gjøre inndataressursene om til en ny kort video.

Velg en effektscene

  • Effekter med ett bilde bruker effect_scene sammen med input.image og input.duration
  • Effekter for interaksjon mellom to personer bruker effect_scene sammen med input.images med nøyaktig to bilder
  • Inndatabildene må oppfylle Klings pikselkrav; svært små miniatyrbilder blir avvist av genereringsoppgaven
  • Den nøyaktige ressursformen avhenger av den valgte effekten, men forespørselen pakker alltid inn effektinnstillinger i input
  • Bruk en effektscene som er tilgjengelig i Kling; CometAPI avviser ukjente effect_scene-verdier
  • Unngå å stole på en fast offentlig enum-liste; tilgjengelige effekter endres etter modellspor og scenefamilie

Oppgaveflyt

1

Send inn effektforespørselen

Send effect_scene sammen med det tilhørende input-objektet, og lagre den returnerte oppgave-id-en.
2

Poll oppgaven

Fortsett med Hent en Kling-oppgave til effektjobben er fullført.
3

Lagre den endelige ressursen

Last ned eller speil den ferdige effektvideoen hvis du trenger stabil lagring.
For fullstendig parameterreferanse, se den offisielle Kling-dokumentasjonen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

application/json
effect_scene
string
påkrevd

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
påkrevd

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.

Svar

200 - application/json

Task accepted.

code
integer
påkrevd

Error code; specific error code definition

message
string
påkrevd

Error message

data
object
påkrevd
Sist endret 25. juni 2026