Kling AI Provider

The Kling AI provider contains support for Kling AI's video generation models, starting with motion control video generation.

Setup

The Kling AI provider is available in the @ai-sdk/klingai module. You can install it with

pnpm add @ai-sdk/klingai

Provider Instance

You can import the default provider instance klingai from @ai-sdk/klingai:

1
import { klingai } from '@ai-sdk/klingai';

If you need a customized setup, you can import createKlingAI from @ai-sdk/klingai and create a provider instance with your settings:

1
import { createKlingAI } from '@ai-sdk/klingai';
2

3
const klingai = createKlingAI({
4
  accessKey: 'your-access-key',
5
  secretKey: 'your-secret-key',
6
});

You can use the following optional settings to customize the Kling AI provider instance:

• accessKey string

  Kling AI access key. Defaults to the KLINGAI_ACCESS_KEY environment variable.

• secretKey string

  Kling AI secret key. Defaults to the KLINGAI_SECRET_KEY environment variable.

• baseURL string

  Use a different URL prefix for API calls, e.g. to use proxy servers. The default prefix is https://api-singapore.klingai.com.

• headers Record<string,string>

  Custom headers to include in the requests.

• fetch (input: RequestInfo, init?: RequestInit) => Promise<Response>

  Custom fetch implementation. You can use it as a middleware to intercept requests, or to provide a custom fetch implementation for e.g. testing.

Video Models

You can create Kling AI video models using the .video() factory method. For more on video generation with the AI SDK see generateVideo().

Basic Usage

1
import { klingai, type KlingAIVideoProviderOptions } from '@ai-sdk/klingai';
2
import { experimental_generateVideo as generateVideo } from 'ai';
3

4
const { videos } = await generateVideo({
5
  model: klingai.video('kling-v2.6-motion-control'),
6
  prompt: {
7
    image: 'https://example.com/character.png',
8
    text: 'The character performs a smooth dance move',
9
  },
10
  providerOptions: {
11
    klingai: {
12
      videoUrl: 'https://example.com/reference-motion.mp4',
13
      characterOrientation: 'image',
14
      mode: 'std',
15
    } satisfies KlingAIVideoProviderOptions,
16
  },
17
});

Provider Options

The following provider options are available via providerOptions.klingai:

• videoUrl string (required)

  URL of the reference motion video. The character actions in the generated video will match this reference. Supports .mp4/.mov, max 100MB, duration 3–30 seconds.

• characterOrientation 'image' | 'video' (required)

  Orientation of the characters in the generated video. 'image' matches the reference image orientation (max 10s video). 'video' matches the reference video orientation (max 30s video).

• mode 'std' | 'pro' (required)

  Video generation mode. 'std' is cost-effective. 'pro' produces higher quality but takes longer.

• keepOriginalSound 'yes' | 'no'

  Whether to keep the original sound from the reference video. Defaults to 'yes'.

• watermarkEnabled boolean

  Whether to generate watermarked results simultaneously.

• pollIntervalMs number

  Polling interval in milliseconds for checking task status. Defaults to 5000.

• pollTimeoutMs number

  Maximum wait time in milliseconds for video generation. Defaults to 600000 (10 minutes).

Model Capabilities