> ## Documentation Index > Fetch the complete documentation index at: https://docs.modellix.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling Video Effects > [Core Function] Kling Video Effects applies predefined visual effects to images. [Strengths] It automatically transforms 1 or 2 images into engaging short videos using viral/predefined effect templates. [Best For] Highly recommended for: social media trends and quick visual gags. [Limitations] Do NOT use this model for custom narrative generation or prompt-based control. [Routing] Use this when the user explicitly requests an 'effect' or 'trend' template applied to their photos. ## OpenAPI ````yaml /model-api/kling/kling-i2v.json post /kling/kling-video-effects openapi: 3.1.0 info: description: The image-to-video models API from Kling AI. version: 1.0.0 contact: name: Modellix Support email: support@modellix.ai title: Kling Image-to-Video Models API servers: - url: https://api.modellix.ai/api/v1 description: The image-to-video models API from Kling AI. security: - bearerAuth: [] paths: /kling/kling-video-effects: post: summary: Kling Video Effects description: >- [Core Function] Kling Video Effects applies predefined visual effects to images. [Strengths] It automatically transforms 1 or 2 images into engaging short videos using viral/predefined effect templates. [Best For] Highly recommended for: social media trends and quick visual gags. [Limitations] Do NOT use this model for custom narrative generation or prompt-based control. [Routing] Use this when the user explicitly requests an 'effect' or 'trend' template applied to their photos. operationId: klingVideoEffectsAsync requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/KlingVideoEffectsRequest' examples: single_image_effect: summary: Single-image effect value: effect_scene: pet_lion_pro image: https://example.com/image.jpg duration: 5 two_person_effect: summary: Two-person effect value: effect_scene: hug_pro images: - https://example.com/image1.jpg - https://example.com/image2.jpg duration: 5 responses: '200': description: Task submitted successfully content: application/json: schema: $ref: '#/components/schemas/AsyncTaskResponse' example: code: 0 message: success data: status: pending task_id: task-effects001 model_id: model-123 get_result: method: GET url: https://api.modellix.ai/api/v1/tasks/task-effects001 '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '429': $ref: '#/components/responses/TooManyRequests' '500': $ref: '#/components/responses/InternalServerError' components: schemas: KlingVideoEffectsRequest: type: object required: - effect_scene properties: effect_scene: type: string description: >- 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 minLength: 1 example: pet_lion_pro image: type: string description: >- 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. minLength: 1 example: https://example.com/image.jpg images: type: array description: >- 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'. minItems: 2 maxItems: 2 items: type: string minLength: 1 example: - https://example.com/image1.jpg - https://example.com/image2.jpg duration: type: integer description: >- Video duration in seconds: 5 or 10. Different effects may support different durations. Optional. enum: - 5 - 10 example: 5 oneOf: - required: - image - required: - images AsyncTaskResponse: type: object required: - code - message - data properties: code: type: integer description: Response code, 0 indicates success example: 0 message: type: string description: Response message example: success data: type: object required: - status - task_id - model_id properties: status: type: string enum: - pending - processing description: Task status example: pending task_id: type: string description: Unique task identifier example: task-abc123 model_id: type: string description: Model ID example: model-123 get_result: type: object description: API information to query the task result properties: method: type: string description: HTTP method example: GET url: type: string description: Full URL to query the task result example: https://api.modellix.ai/api/v1/tasks/task-abc123 description: Detailed data about the submitted asynchronous task. ErrorResponse: type: object required: - code - message properties: code: type: integer description: Error code (equals HTTP status code) example: 400 message: type: string description: Error message example: 'Invalid parameters: parameter ''image'' is required' responses: BadRequest: description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 400 message: 'Invalid parameters: parameter ''image'' is required' Unauthorized: description: Unauthorized - Invalid or missing API Key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 401 message: 'Authentication failed: invalid API key' TooManyRequests: description: Too many requests - Rate limit exceeded headers: X-RateLimit-Limit: description: Maximum requests per minute schema: type: integer example: 100 X-RateLimit-Remaining: description: Remaining quota in current window schema: type: integer example: 0 X-RateLimit-Reset: description: Rate limit window reset time (Unix timestamp) schema: type: integer example: 1704067260 content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 429 message: >- Rate limit exceeded: 100 requests per minute, retry after 60 seconds InternalServerError: description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: code: 500 message: Internal server error securitySchemes: bearerAuth: type: http scheme: bearer description: 'API Key authentication. Format: `Bearer YOUR_API_KEY`.' ````