Parameters
| Name | Description | Type | Required | Enums |
|---|---|---|---|---|
| effect_scene | Effect scene name. Supports 212 video effects total: 208 single-image effects (e.g., pet_lion_pro, cute_dance, bullet_time) and 4 two-person effects (cheers_2026, fight_pro, hug_pro, heart_gesture_pro). For complete list, see: https://app.klingai.com/global/dev/document-api/quickStart/productIntroduction/effectsCenter | string | Yes | - |
| duration | Video duration in seconds: 5 or 10. Different effects may support different durations. Optional. | integer | No | 5, 10 |
| image | Reference image for single-image effects. Supports URL or Base64 encoded string. Mutually exclusive with ‘images’ - use ‘image’ for single-image effects, ‘images’ for two-person effects. Supported formats: JPG/JPEG/PNG. Maximum file size: 10MB. Minimum resolution: 300x300px. Aspect ratio should be between 1:2.5 and 2.5:1. Do not include Base64 prefix. | string | No | - |
| images | Reference image array for two-person effects. Mutually exclusive with ‘image’. Must contain exactly 2 images. The first image will be positioned on the left, the second on the right. Each image supports URL or Base64 encoding. Same format and size requirements as ‘image’. | string[] | No | - |
Pricing
Unit: $/sec
| Pricing |
|---|
| $1.2600/sec |
