> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.deerapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Kling Multi Image To Video

> Use DeerAPI to call the Kling Multi Image To Video endpoint with request details, response details, examples, and an OpenAPI playground.

## Overview

Use this endpoint to call the Kling Multi Image To Video workflow through DeerAPI. The API reference on this page shows the request schema, response schema, authentication requirements, and runnable examples for the configured endpoint.

## Before you start

Use the DeerAPI base URL and pass your API Key in the `Authorization` header:

```text theme={null}
https://api.deerapi.com
```

```text theme={null}
Authorization: Bearer $DEERAPI_KEY
```

## Model selection

Choose a current model ID from the [live pricing page](https://api.deerapi.com/pricing). Model availability changes over time, so avoid copying a model ID from an old project without checking the live list first.

## Implementation notes

* Use the OpenAPI playground for the exact request fields accepted by this endpoint.
* Keep API Keys on the server side when you build production applications.
* Log the request ID from failed calls so support can investigate the request.
* Retry `429`, `500`, and `503` responses with exponential backoff.


## OpenAPI

````yaml /api/openapi/video/kling/post-multi-img-to-video.openapi.json POST /kling/v1/videos/multi-image2video
openapi: 3.1.0
info:
  title: DeerAPI Kling Multi Image to Video
  description: Use this field according to the endpoint schema.
  version: 1.0.0
servers:
  - url: https://api.deerapi.com
security:
  - bearerAuth: []
paths:
  /kling/v1/videos/multi-image2video:
    post:
      summary: DeerAPI Kling Multi Image to Video
      description: Use this field according to the endpoint schema.
      operationId: createKlingMultiImageToVideo
      requestBody:
        description: Use this field according to the endpoint schema.
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - model_name
                - duration
                - image_list
                - prompt
              properties:
                model_name:
                  type: string
                  description: kling-v1-6
                  default: kling-v1-6
                duration:
                  type: string
                  description: Use this field according to the endpoint schema.
                  default: example
                image_list:
                  type: array
                  description: Use this field according to the endpoint schema.
                  items:
                    type: object
                    required:
                      - image
                    properties:
                      image:
                        type: string
                  default:
                    - {}
                prompt:
                  type: string
                  description: Use this field according to the endpoint schema.
                  default: Hello
                negative_prompt:
                  type: string
                  description: Use this field according to the endpoint schema.
                callback_url:
                  type: string
                  description: Use this field according to the endpoint schema.
                mode:
                  type: string
                  description: Use this field according to the endpoint schema.
                cfg_scale:
                  type: number
                  description: Use this field according to the endpoint schema.
                static_mask:
                  type: string
                  description: Use this field according to the endpoint schema.
                dynamic_masks:
                  type: object
                  description: Use this field according to the endpoint schema.
                  properties:
                    mask:
                      type: string
                    trajectories:
                      type: object
                      properties:
                        x:
                          type: integer
                          description: >-
                            Horizontal coordinates of the track point (pixel
                            coordinates in a pixel 2D coordinate system with the
                            origin at the bottom left of the input image IMAGE)
                        'y':
                          type: integer
                          description: >-
                            Vertical coordinates of the track point (pixel
                            coordinates in a pixel 2D coordinate system with the
                            origin at the bottom left of the input image IMAGE)
                external_task_id:
                  type: string
                  description: Use this field according to the endpoint schema.
              default:
                model_name: kling-v1-6
                duration: example
                image_list:
                  - {}
                prompt: A cinematic shot of a quiet city street at sunset.
            examples:
              default:
                summary: DeerAPI Kling Multi Image to Video
                value:
                  model_name: kling-v1-6
                  duration: '5'
                  image_list:
                    - image: https://example.com/subject-1.png
                    - image: https://example.com/subject-2.png
                  prompt: >-
                    A cinematic shot of a modern glass workspace at sunrise with
                    smooth camera movement.
                  callback_url: https://example.com/kling/callback
            example:
              model_name: kling-v1-6
              duration: '5'
              image_list:
                - image: https://example.com/subject-1.png
                - image: https://example.com/subject-2.png
              prompt: >-
                A cinematic shot of a modern glass workspace at sunrise with
                smooth camera movement.
              callback_url: https://example.com/kling/callback
      responses:
        '200':
          description: Use this field according to the endpoint schema.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - request_id
                  - data
                properties:
                  code:
                    type: integer
                    description: Use this field according to the endpoint schema.
                  message:
                    type: string
                    description: Use this field according to the endpoint schema.
                  request_id:
                    type: string
                    description: Use this field according to the endpoint schema.
                  data:
                    type: object
                    required:
                      - task_id
                      - task_status
                      - task_status_msg
                      - task_info
                      - task_result
                      - created_at
                      - updated_at
                    properties:
                      task_id:
                        type: string
                        description: Use this field according to the endpoint schema.
                      task_status:
                        type: string
                        description: Use this field according to the endpoint schema.
                      task_status_msg:
                        type: string
                      task_info:
                        type: object
                        required:
                          - external_task_id
                        properties:
                          external_task_id:
                            type: string
                      task_result:
                        type: object
                        required:
                          - videos
                        properties:
                          videos:
                            type: object
                            required:
                              - id
                              - duration
                              - url
                            properties:
                              id:
                                type: string
                              url:
                                type: string
                              duration:
                                type: string
                      created_at:
                        type: integer
                        description: Use this field according to the endpoint schema.
                      updated_at:
                        type: integer
                        description: Use this field according to the endpoint schema.
      x-codeSamples:
        - lang: Shell
          label: cURL
          source: |
            curl https://api.deerapi.com/kling/v1/videos/multi-image2video \
              -H "Content-Type: application/json" \
              -H "Authorization: Bearer $DEERAPI_KEY" \
              -d '{
                "model_name": "kling-v1-6",
                "duration": "5",
                "image_list": [
                  {
                    "image": "https://example.com/subject-1.png"
                  },
                  {
                    "image": "https://example.com/subject-2.png"
                  }
                ],
                "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
                "callback_url": "https://example.com/kling/callback"
              }'
        - lang: Python
          label: requests
          source: |
            import os
            import requests

            url = "https://api.deerapi.com/kling/v1/videos/multi-image2video"
            headers = {
                "Authorization": "Bearer " + os.environ["DEERAPI_KEY"],
                "Content-Type": "application/json",
            }
            payload = {
              "model_name": "kling-v1-6",
              "duration": "5",
              "image_list": [
                {
                  "image": "https://example.com/subject-1.png"
                },
                {
                  "image": "https://example.com/subject-2.png"
                }
              ],
              "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
              "callback_url": "https://example.com/kling/callback"
            }

            response = requests.post(url, headers=headers, json=payload)
            print(response.json())
        - lang: JavaScript
          label: fetch
          source: >
            const response = await
            fetch("https://api.deerapi.com/kling/v1/videos/multi-image2video", {
              method: "POST",
              headers: {
                Authorization: `Bearer ${process.env.DEERAPI_KEY}`,
                "Content-Type": "application/json",
              },
              body: JSON.stringify({
                "model_name": "kling-v1-6",
                "duration": "5",
                "image_list": [
                  {
                    "image": "https://example.com/subject-1.png"
                  },
                  {
                    "image": "https://example.com/subject-2.png"
                  }
                ],
                "prompt": "A cinematic shot of a modern glass workspace at sunrise with smooth camera movement.",
                "callback_url": "https://example.com/kling/callback"
              }),
            });


            console.log(await response.json());
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Use a DeerAPI API Key as a Bearer token.

````