> ## Documentation Index > Fetch the complete documentation index at: https://docs.evolink.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kling-V3 Image to Video > - Kling-V3 Image to Video (kling-v3-image-to-video) model supports image-to-video generation - Supports first frame, last frame, element control, multi-shot, and sound effects - Asynchronous processing mode, use the returned task ID to [query status](/en/api-manual/task-management/get-task-detail) - Generated video links are valid for 24 hours, please save them promptly ## OpenAPI ````yaml /en/api-manual/video-series/kling/kling-v3-image-to-video.json POST /v1/videos/generations openapi: 3.1.0 info: title: kling-v3-image-to-video API description: Create image-to-video tasks using AI models license: name: MIT version: 1.0.0 servers: - url: https://api.evolink.ai description: Production security: - bearerAuth: [] tags: - name: Video Generation description: AI video generation APIs paths: /v1/videos/generations: post: tags: - Video Generation summary: kling-v3-image-to-video API description: >- - Kling-V3 Image to Video (kling-v3-image-to-video) model supports image-to-video generation - Supports first frame, last frame, element control, multi-shot, and sound effects - Asynchronous processing mode, use the returned task ID to [query status](/en/api-manual/task-management/get-task-detail) - Generated video links are valid for 24 hours, please save them promptly operationId: createVideoGeneration requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/VideoGenerationRequest' examples: basic: summary: First Frame Image to Video value: model: kling-v3-image-to-video prompt: The person in the scene slowly turns their head and smiles image_start: https://example.com/portrait.jpg duration: 5 quality: 720p first_last_frame: summary: First and Last Frame value: model: kling-v3-image-to-video prompt: Transition from day to night image_start: https://example.com/day.jpg image_end: https://example.com/night.jpg duration: 10 quality: 1080p sound: 'on' with_element: summary: With Element Control value: model: kling-v3-image-to-video prompt: <<>> is dancing in the scene image_start: https://example.com/background.jpg duration: 8 quality: 1080p model_params: element_list: - element_id: '123456' multi_shot: summary: Multi-Shot Image to Video value: model: kling-v3-image-to-video image_start: https://example.com/portrait.jpg duration: 10 quality: 1080p model_params: multi_shot: true shot_type: customize multi_prompt: - index: 1 prompt: A person sitting in the park duration: '5' - index: 2 prompt: Camera switches to a full street view duration: '5' responses: '200': description: Video generation task created successfully content: application/json: schema: $ref: '#/components/schemas/VideoGenerationResponse' '400': description: Invalid request parameters content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: invalid_request message: Invalid request parameters type: invalid_request_error '401': description: Unauthenticated, invalid or expired token content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: unauthorized message: Invalid or expired token type: authentication_error '402': description: Insufficient quota, recharge required content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: insufficient_quota message: Insufficient quota. Please top up your account. type: insufficient_quota '403': description: Access denied content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: model_access_denied message: 'Token does not have access to model: kling-v3-image-to-video' type: invalid_request_error '429': description: Rate limit exceeded content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: rate_limit_exceeded message: Too many requests, please try again later type: rate_limit_error '500': description: Internal server error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: error: code: internal_error message: Internal server error type: api_error components: schemas: VideoGenerationRequest: type: object required: - model - image_start properties: model: type: string description: Video generation model name enum: - kling-v3-image-to-video default: kling-v3-image-to-video example: kling-v3-image-to-video image_start: type: string format: uri description: >- First frame image URL for image-to-video generation (**required**) **Note:** - Image size: up to `10MB` - Supported formats: `.jpg`, `.jpeg`, `.png` - Image dimensions: width and height >= `300px`, aspect ratio between `1:2.5` and `2.5:1` - Image URL must be directly accessible by the server or trigger a direct download when accessed example: https://example.com/portrait.jpg image_end: type: string format: uri description: >- Last frame image URL **Note:** - `image_start` (first frame) must be provided when using last frame - Supported formats: `.jpg`, `.jpeg`, `.png` - Image size: up to `10MB` - Image URL must be directly accessible by the server or trigger a direct download when accessed example: https://example.com/night.jpg prompt: type: string description: >- Text prompt describing what video to generate **Note:** - Maximum `2500` characters - Can be empty when `multi_shot=true` and `shot_type=customize` - Use `<<>>` reference syntax to reference elements in the prompt example: The person in the scene slowly turns their head and smiles maxLength: 2500 negative_prompt: type: string description: Negative prompt describing content you do not want in the video example: text, watermark duration: type: integer description: >- Video duration in seconds, defaults to `5` seconds **Note:** - Range: integer from `3` to `15` - Billing is based on the `duration` value, longer duration costs more minimum: 3 maximum: 15 default: 5 example: 5 quality: type: string description: |- Resolution tier **Options:** - `720p`: Standard quality (std) - `1080p`: High quality (pro) - `4k`: Ultra-high definition 4K enum: - 720p - 1080p - 4k default: 720p example: 720p sound: type: string description: |- Sound effect control **Options:** - `on`: Generate sound effects - `off`: No sound effects enum: - 'on' - 'off' default: 'off' example: 'off' model_params: type: object description: Advanced parameters for multi-shot, element control, and watermark properties: multi_shot: type: boolean description: >- Whether to enable multi-shot mode **Options:** - `true`: Multi-shot mode, must be used with `shot_type`. When `shot_type=customize`, **the `prompt` parameter will be ignored** — use `multi_prompt` to define content for each shot instead; when `shot_type=intelligence`, `prompt` remains effective. **The sum of all shot `duration` values must equal the total video duration** - `false`: Single-shot mode (default) default: false example: false shot_type: type: string description: >- Shot segmentation method, **required** when `multi_shot=true` **Options:** - `customize`: Custom shots, requires `multi_prompt` - `intelligence`: Intelligent shots, model automatically segments shots enum: - customize - intelligence example: customize multi_prompt: type: array description: >- Shot information list, **required** when `multi_shot=true` and `shot_type=customize` **Note:** - Maximum `6` shots, minimum `1` - Each shot prompt is up to `512` characters - Each shot duration >= 1 and <= total duration - **The sum of all shot durations must equal the total task duration** items: type: object properties: index: type: integer description: Shot sequence number, starting from 1 prompt: type: string description: Text description for this shot maxLength: 512 duration: type: string description: Duration of this shot (seconds) required: - index - prompt - duration minItems: 1 maxItems: 6 element_list: type: array description: >- Element library list for referencing preset elements in the video **Note:** - Maximum `3` elements - Use `<<>>` reference syntax in the prompt to reference elements items: type: object properties: element_id: type: string description: Element ID required: - element_id maxItems: 3 watermark_info: type: object description: Watermark configuration properties: enabled: type: boolean description: Whether to enable watermark callback_url: type: string description: >- HTTPS callback URL for task completion **Callback Timing:** - Triggered when task is completed, failed, or cancelled - Sent after billing confirmation **Security Restrictions:** - HTTPS protocol only - Internal IP addresses are prohibited (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.) - URL length must not exceed `2048` characters **Callback Mechanism:** - Timeout: `10` seconds - Maximum `3` retries after failure (at `1`/`2`/`4` seconds after failure) - Callback response format is consistent with task query API - 2xx status code is considered successful, other codes trigger retry format: uri example: https://your-domain.com/webhooks/video-task-completed VideoGenerationResponse: type: object properties: created: type: integer description: Task creation timestamp example: 1757169743 id: type: string description: Task ID example: task-unified-1757169743-7cvnl5zw model: type: string description: Actual model name used example: kling-v3-image-to-video object: type: string enum: - video.generation.task description: Task type progress: type: integer description: Task progress percentage (0-100) minimum: 0 maximum: 100 example: 0 status: type: string description: Task status enum: - pending - processing - completed - failed example: pending task_info: $ref: '#/components/schemas/VideoTaskInfo' description: Video task details type: type: string enum: - text - image - audio - video description: Task output type example: video usage: $ref: '#/components/schemas/VideoUsage' description: Usage and billing information ErrorResponse: type: object properties: error: type: object properties: code: type: string description: Error code identifier message: type: string description: Error description type: type: string description: Error type VideoTaskInfo: type: object properties: can_cancel: type: boolean description: Whether the task can be cancelled example: true estimated_time: type: integer description: Estimated completion time (seconds) minimum: 0 example: 300 video_duration: type: integer description: Video duration (seconds) example: 5 VideoUsage: type: object description: Usage and billing information properties: billing_rule: type: string description: Billing rule enum: - per_call - per_token - per_second example: per_second credits_reserved: type: number description: Estimated credits consumed minimum: 0 example: 270000 user_group: type: string description: User group category example: default securitySchemes: bearerAuth: type: http scheme: bearer description: >- ## All APIs require Bearer Token authentication ## **Get API Key:** Visit [API Key Management Page](https://evolink.ai/dashboard/keys) to get your API Key **Add to request header:** ``` Authorization: Bearer YOUR_API_KEY ``` ````