v1.6-standard/multi-image-to-video

This documentation is valid for the following list of our models:

• kling-video/v1.6/standard/multi-image-to-video

This model creates dynamic videos from multiple input images with enhanced temporal consistency and natural transitions.

Setup your API Key

If you don’t have an API key for the AI/ML API yet, feel free to use our Quickstart guide.

How to Make a Call

Step-by-Step Instructions

Generating a video using this model involves sequentially calling two endpoints:

• The first one is for creating and sending a video generation task to the server (returns a generation ID).

• The second one is for requesting the generated video from the server using the generation ID received from the first endpoint.

Below, you can find both corresponding API schemas.

API Schemas

Create a video generation task and send it to the server

post

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Body

application/json

modelundefined · enumRequiredPossible values:

typestring · enumOptionalPossible values:

image_liststring · uri[] · min: 2 · max: 4Required

Array of image URLs (2-10 images) for multi-image-to-video generation

aspect_ratiostring · enumOptional

The aspect ratio of the generated video.

Default: 16:9Possible values:

negative_promptstringOptional

The description of elements to avoid in the generated video.

durationinteger · enumOptional

The length of the output video in seconds.

Possible values:

external_task_idstringOptional

Customized Task ID

promptstringOptional

The text description of the scene, subject, or action to generate in the video.

Responses

200

Successfully generated video

application/json

post

/v2/generate/video/kling/generation

HTTPcURLJavaScriptPython

POST /v2/generate/video/kling/generation HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 227

{
  "model": "kling-video/v1.6/standard/multi-image-to-video",
  "type": "multi-image-to-video",
  "image_list": [
    "https://example.com"
  ],
  "aspect_ratio": "16:9",
  "negative_prompt": "text",
  "duration": 5,
  "external_task_id": "text",
  "prompt": "text"
}

200

Successfully generated video

{
  "id": "text",
  "status": "queued",
  "video": {
    "url": "https://example.com",
    "duration": 1
  },
  "duration": 1,
  "error": null,
  "meta": {
    "usage": {
      "tokens_used": 1
    }
  }
}

Retrieve the generated video from the server

After sending a request for video generation, this task is added to the queue. Based on the service's load, the generation can be completed in seconds or take a bit more.

get

Authorizations

access-token

AuthorizationstringRequired

Bearer key

Query parameters

generation_idstringRequired

Responses

200

Successfully generated video

application/json

get

/v2/generate/video/kling/generation

HTTPcURLJavaScriptPython

GET /v2/generate/video/kling/generation?generation_id=text HTTP/1.1
Host: api.aimlapi.com
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

Successfully generated video

{
  "id": "text",
  "status": "queued",
  "video": {
    "url": "https://example.com",
    "duration": 1
  },
  "duration": 1,
  "error": null,
  "meta": {
    "usage": {
      "tokens_used": 1
    }
  }
}