Apply a preset Kling visual effect (single- or dual-image scenes).
Authenticate with the X-API-Key request header.
resolution — pass resolution in your request. Credit cost per second:| resolution | credits / sec | vs base |
|---|---|---|
| 720p | 19 | 1× |
| 1080p | 30 | 1.6× |
List price. Volume / bulk customers get a discounted rate — contact us for account pricing.
| Name | Type | Required | Description | Default / options |
|---|---|---|---|---|
| effect_scene | string | required | Effect preset to apply. | bloombloomdizzydizzyfuzzyfuzzysquishexpansionhugkissheart_gesture |
| image_url | string | optional | Single source image (required for single-image effects). | — |
| image_urls | string[] | optional | Exactly 2 images (required for dual effects: hug, kiss, heart_gesture). | — |
| duration | number | optional | Clip length in seconds. | default: 5510 |
| mode | string | optional | Quality mode. | default: stdstdpro |
| external_task_id | string | optional | Caller-supplied correlation/idempotency id. | — |
| callback_url | string | optional | Webhook URL notified when the task completes. | — |
curl -X POST https://brahmand-api.bulletshorts.co/v1/video/kling-effects \
-H "X-API-Key: $TRINETRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{"effect_scene":"squish","image_url":"https://example.com/toy.jpg","duration":5}'{
"effect_scene": "squish",
"image_url": "https://example.com/toy.jpg",
"duration": 5
}Submitting a job returns 202 Accepted with a job id. Poll GET /v1/jobs/{id} until the job reaches a terminal state, or register a webhook to be notified.
{
"job_id": "job_klingeffects_a1b2c3",
"status": "queued"
}{
"id": "job_klingeffects_a1b2c3",
"model": "kling-effects",
"status": "succeeded",
"output": {
"outputs": [
{
"url": "https://cdn.trinetra.ai/out/kling-effects/a1b2c3.mp4",
"type": "video"
}
]
},
"credits_charged": 10
}Webhook: set a webhook_url on your API key to receive a POST with the terminal job document instead of polling.