Skip to main content
POST
cURL
Gebruik dit endpoint om een van de vooraf ingestelde effectscènes van Kling toe te passen en de invoerassets om te zetten in een nieuwe korte video.

Een effectscène kiezen

  • Effecten met één afbeelding gebruiken effect_scene plus input.image en input.duration
  • Effecten met interactie tussen twee personen gebruiken effect_scene plus input.images met precies twee afbeeldingen
  • Invoerafbeeldingen moeten voldoen aan de pixelvereisten van Kling; piepkleine miniaturen worden door de generatietaak geweigerd
  • De exacte vorm van de asset hangt af van het geselecteerde effect, maar het verzoek verpakt effectinstellingen altijd binnen input
  • Gebruik een effectscène die momenteel beschikbaar is in Kling; CometAPI weigert onbekende effect_scene-waarden
  • Vermijd te vertrouwen op een vaste openbare enum-lijst; de beschikbaarheid van effecten verandert per modeltrack en scenefamilie

Taakverloop

1

Het effectverzoek indienen

Stuur effect_scene plus het bijpassende input-object en sla de geretourneerde taak-id op.
2

De taak pollen

Ga verder met Een Kling-taak ophalen totdat de effecttaak is voltooid.
3

De uiteindelijke asset opslaan

Download of mirror de voltooide effectvideo als je stabiele bewaring nodig hebt.
Zie voor de volledige parameterreferentie de officiële Kling-documentatie.

Autorisaties

Authorization
string
header
vereist

Bearer token authentication. Use your CometAPI key.

Body

application/json
effect_scene
string
vereist

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
vereist

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.

Respons

200 - application/json

Task accepted.

code
integer
vereist

Error code; specific error code definition

message
string
vereist

Error message

data
object
vereist