@ai-sdk/klingai 0.0.0-b66d09a8-20260328011513

package/CHANGELOG.md

@@ -0,0 +1,152 @@
+# @ai-sdk/klingai
+
+## 0.0.0-b66d09a8-20260328011513
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- e569f5d: feat (provider/klingai): add kling v3.0 motion control support
+- Updated dependencies [531251e]
+- Updated dependencies [1f509d4]
+- Updated dependencies [5c2a5a2]
+- Updated dependencies [f7d4f01]
+- Updated dependencies [776b617]
+- Updated dependencies [3887c70]
+- Updated dependencies [61753c3]
+- Updated dependencies [8359612]
+  - @ai-sdk/provider-utils@0.0.0-b66d09a8-20260328011513
+  - @ai-sdk/provider@0.0.0-b66d09a8-20260328011513
+
+## 4.0.0-beta.8
+
+### Patch Changes
+
+- Updated dependencies [1f509d4]
+  - @ai-sdk/provider-utils@5.0.0-beta.7
+  - @ai-sdk/provider@4.0.0-beta.5
+
+## 4.0.0-beta.7
+
+### Patch Changes
+
+- Updated dependencies [3887c70]
+  - @ai-sdk/provider-utils@5.0.0-beta.6
+  - @ai-sdk/provider@4.0.0-beta.4
+
+## 4.0.0-beta.6
+
+### Patch Changes
+
+- Updated dependencies [776b617]
+  - @ai-sdk/provider-utils@5.0.0-beta.5
+  - @ai-sdk/provider@4.0.0-beta.3
+
+## 4.0.0-beta.5
+
+### Patch Changes
+
+- Updated dependencies [61753c3]
+  - @ai-sdk/provider-utils@5.0.0-beta.4
+
+## 4.0.0-beta.4
+
+### Patch Changes
+
+- Updated dependencies [f7d4f01]
+  - @ai-sdk/provider-utils@5.0.0-beta.3
+  - @ai-sdk/provider@4.0.0-beta.2
+
+## 4.0.0-beta.3
+
+### Patch Changes
+
+- Updated dependencies [5c2a5a2]
+  - @ai-sdk/provider@4.0.0-beta.1
+  - @ai-sdk/provider-utils@5.0.0-beta.2
+
+## 4.0.0-beta.2
+
+### Patch Changes
+
+- e569f5d: feat (provider/klingai): add kling v3.0 motion control support
+
+## 4.0.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [531251e]
+  - @ai-sdk/provider-utils@5.0.0-beta.1
+
+## 4.0.0-beta.0
+
+### Major Changes
+
+- 8359612: Start v7 pre-release
+
+### Patch Changes
+
+- Updated dependencies [8359612]
+  - @ai-sdk/provider@4.0.0-beta.0
+  - @ai-sdk/provider-utils@5.0.0-beta.0
+
+## 3.0.8
+
+### Patch Changes
+
+- Updated dependencies [ad4cfc2]
+  - @ai-sdk/provider-utils@4.0.19
+
+## 3.0.7
+
+### Patch Changes
+
+- Updated dependencies [824b295]
+  - @ai-sdk/provider-utils@4.0.18
+
+## 3.0.6
+
+### Patch Changes
+
+- Updated dependencies [08336f1]
+  - @ai-sdk/provider-utils@4.0.17
+
+## 3.0.5
+
+### Patch Changes
+
+- Updated dependencies [58bc42d]
+  - @ai-sdk/provider-utils@4.0.16
+
+## 3.0.4
+
+### Patch Changes
+
+- 3b19702: feat (provider/klingai): add kling v3.0 t2v and i2v support
+
+## 3.0.3
+
+### Patch Changes
+
+- Updated dependencies [4024a3a]
+  - @ai-sdk/provider-utils@4.0.15
+
+## 3.0.2
+
+### Patch Changes
+
+- 99fbed8: feat: normalize provider specific model options type names and ensure they are exported
+
+## 3.0.1
+
+### Patch Changes
+
+- c43aeb2: feat (provider/klingai): add text-to-video and image-to-video support
+
+## 3.0.0
+
+### Major Changes
+
+- cc12a89: feat (provider/klingai): initial klingai provider

package/LICENSE

@@ -0,0 +1,13 @@
+Copyright 2023 Vercel, Inc.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,157 @@
+# AI SDK - Kling AI Provider
+
+The **Kling AI provider** for the [AI SDK](https://ai-sdk.dev/docs) contains video model support for the [Kling AI API](https://app.klingai.com/global/dev/document-api/quickStart/productIntroduction/overview).
+
+## Setup
+
+The Kling AI provider is available in the `@ai-sdk/klingai` module. You can install it with:
+
+```bash
+npm i @ai-sdk/klingai
+```
+
+## Skill for Coding Agents
+
+If you use coding agents such as Claude Code or Cursor, we highly recommend adding the AI SDK skill to your repository:
+
+```shell
+npx skills add vercel/ai
+```
+
+## Provider Instance
+
+You can import the default provider instance `klingai` from `@ai-sdk/klingai`:
+
+```ts
+import { klingai } from '@ai-sdk/klingai';
+```
+
+## Video Models
+
+This provider currently supports three video generation modes: text-to-video, image-to-video, and motion control.
+
+> **Note:** Not all options are supported by every model version and mode combination. See the [KlingAI Capability Map](https://app.klingai.com/global/dev/document-api/apiReference/model/skillsMap) for detailed compatibility.
+
+### Text-to-Video
+
+Generate video from a text prompt.
+
+Available models: `kling-v1-t2v`, `kling-v1.6-t2v`, `kling-v2-master-t2v`, `kling-v2.1-master-t2v`, `kling-v2.5-turbo-t2v`, `kling-v2.6-t2v`
+
+```ts
+import { klingai } from '@ai-sdk/klingai';
+import { experimental_generateVideo } from 'ai';
+
+const { videos } = await experimental_generateVideo({
+  model: klingai.video('kling-v2.6-t2v'),
+  prompt: 'A chicken flying into the sunset in the style of 90s anime.',
+  aspectRatio: '16:9',
+  duration: 5,
+  providerOptions: {
+    klingai: {
+      mode: 'std',
+    },
+  },
+});
+```
+
+### Image-to-Video
+
+Generate video from a start frame image, with optional end frame control.
+
+Available models: `kling-v1-i2v`, `kling-v1.5-i2v`, `kling-v1.6-i2v`, `kling-v2-master-i2v`, `kling-v2.1-i2v`, `kling-v2.1-master-i2v`, `kling-v2.5-turbo-i2v`, `kling-v2.6-i2v`
+
+```ts
+import { klingai } from '@ai-sdk/klingai';
+import { experimental_generateVideo } from 'ai';
+
+const { videos } = await experimental_generateVideo({
+  model: klingai.video('kling-v2.6-i2v'),
+  prompt: {
+    image: 'https://example.com/start-frame.png',
+    text: 'The cat slowly turns its head and blinks',
+  },
+  duration: 5,
+  providerOptions: {
+    klingai: {
+      // Pro mode required for start+end frame control
+      mode: 'pro',
+      // Optional: end frame image
+      imageTail: 'https://example.com/end-frame.png',
+    },
+  },
+});
+```
+
+### Motion Control
+
+Generate video using a reference motion video.
+
+Available models: `kling-v2.6-motion-control`
+
+```ts
+import { klingai } from '@ai-sdk/klingai';
+import { experimental_generateVideo } from 'ai';
+
+const { videos } = await experimental_generateVideo({
+  model: klingai.video('kling-v2.6-motion-control'),
+  prompt: {
+    image: 'https://example.com/character.png',
+    text: 'The character performs a smooth dance move',
+  },
+  providerOptions: {
+    klingai: {
+      videoUrl: 'https://example.com/reference-motion.mp4',
+      characterOrientation: 'image',
+      mode: 'std',
+    },
+  },
+});
+```
+
+## Provider Options
+
+Use `providerOptions.klingai` to configure video generation. Options vary by mode:
+
+| Option                 | T2V               | I2V               | Motion Control    | Description                     |
+| ---------------------- | ----------------- | ----------------- | ----------------- | ------------------------------- |
+| `mode`                 | `'std'` / `'pro'` | `'std'` / `'pro'` | `'std'` / `'pro'` | Generation quality mode         |
+| `negativePrompt`       | Yes               | Yes               | —                 | What to avoid (max 2500 chars)  |
+| `sound`                | V2.6+ pro only    | V2.6+ pro only    | —                 | `'on'` / `'off'` for audio      |
+| `cfgScale`             | Yes (V1.x)        | Yes (V1.x)        | —                 | Prompt adherence [0, 1]         |
+| `cameraControl`        | Yes               | Yes               | —                 | Camera movement presets         |
+| `imageTail`            | —                 | Pro mode          | —                 | End frame image (URL or base64) |
+| `staticMask`           | —                 | Yes               | —                 | Static brush mask               |
+| `dynamicMasks`         | —                 | Yes               | —                 | Dynamic brush configs           |
+| `videoUrl`             | —                 | —                 | Required          | Reference motion video URL      |
+| `characterOrientation` | —                 | —                 | Required          | `'image'` or `'video'`          |
+| `keepOriginalSound`    | —                 | —                 | Yes               | `'yes'` / `'no'`                |
+| `watermarkEnabled`     | —                 | —                 | Yes               | Enable watermark                |
+| `pollIntervalMs`       | Yes               | Yes               | Yes               | Poll interval (default: 5000ms) |
+| `pollTimeoutMs`        | Yes               | Yes               | Yes               | Max wait (default: 600000ms)    |
+
+See the [KlingAI Capability Map](https://app.klingai.com/global/dev/document-api/apiReference/model/skillsMap) for which features each model version supports.
+
+## Authentication
+
+Kling AI uses access key / secret key authentication. Set the following environment variables:
+
+```
+KLINGAI_ACCESS_KEY=your-access-key
+KLINGAI_SECRET_KEY=your-secret-key
+```
+
+Or pass them directly:
+
+```ts
+import { createKlingAI } from '@ai-sdk/klingai';
+
+const klingai = createKlingAI({
+  accessKey: 'your-access-key',
+  secretKey: 'your-secret-key',
+});
+```
+
+## Documentation
+
+Please check out the [Kling AI API documentation](https://app.klingai.com/global/dev/document-api/quickStart/productIntroduction/overview) for more information.

package/dist/index.d.mts

@@ -0,0 +1,211 @@
+import { ProviderV4, Experimental_VideoModelV4 } from '@ai-sdk/provider';
+import { FetchFunction } from '@ai-sdk/provider-utils';
+
+type KlingAIVideoModelId = 'kling-v1-t2v' | 'kling-v1.6-t2v' | 'kling-v2-master-t2v' | 'kling-v2.1-master-t2v' | 'kling-v2.5-turbo-t2v' | 'kling-v2.6-t2v' | 'kling-v3.0-t2v' | 'kling-v1-i2v' | 'kling-v1.5-i2v' | 'kling-v1.6-i2v' | 'kling-v2-master-i2v' | 'kling-v2.1-i2v' | 'kling-v2.1-master-i2v' | 'kling-v2.5-turbo-i2v' | 'kling-v2.6-i2v' | 'kling-v3.0-i2v' | 'kling-v2.6-motion-control' | 'kling-v3.0-motion-control' | (string & {});
+
+interface KlingAIProviderSettings {
+    /**
+     * KlingAI Access key. Default value is taken from the `KLINGAI_ACCESS_KEY`
+     * environment variable.
+     */
+    accessKey?: string;
+    /**
+     * KlingAI Secret key. Default value is taken from the `KLINGAI_SECRET_KEY`
+     * environment variable.
+     */
+    secretKey?: string;
+    /**
+     * Base URL for the API calls.
+     */
+    baseURL?: string;
+    /**
+     * Custom headers to include in the requests.
+     */
+    headers?: Record<string, string>;
+    /**
+     * Custom fetch implementation. You can use it as a middleware to intercept
+     * requests, or to provide a custom fetch implementation for e.g. testing.
+     */
+    fetch?: FetchFunction;
+}
+interface KlingAIProvider extends ProviderV4 {
+    /**
+     * Creates a model for video generation.
+     */
+    video(modelId: KlingAIVideoModelId): Experimental_VideoModelV4;
+    /**
+     * Creates a model for video generation.
+     */
+    videoModel(modelId: KlingAIVideoModelId): Experimental_VideoModelV4;
+}
+/**
+ * Create a KlingAI provider instance.
+ */
+declare function createKlingAI(options?: KlingAIProviderSettings): KlingAIProvider;
+/**
+ * Default KlingAI provider instance.
+ */
+declare const klingai: KlingAIProvider;
+
+/**
+ * Provider-specific options for KlingAI video generation.
+ *
+ * Not all options are supported by every model version and video mode (T2V, I2V,
+ * motion control). See the KlingAI capability map for detailed compatibility:
+ * https://app.klingai.com/global/dev/document-api/apiReference/model/skillsMap
+ */
+type KlingAIVideoModelOptions = {
+    /**
+     * Video generation mode.
+     *
+     * - `'std'`: Standard mode — cost-effective.
+     * - `'pro'`: Professional mode — higher quality but longer generation time.
+     */
+    mode?: 'std' | 'pro' | null;
+    /**
+     * Polling interval in milliseconds for checking task status.
+     * Default: 5000 (5 seconds).
+     */
+    pollIntervalMs?: number | null;
+    /**
+     * Maximum time in milliseconds to wait for video generation.
+     * Default: 600000 (10 minutes).
+     */
+    pollTimeoutMs?: number | null;
+    /**
+     * Negative text prompt to specify what to avoid.
+     * Cannot exceed 2500 characters.
+     */
+    negativePrompt?: string | null;
+    /**
+     * Whether to generate sound simultaneously when generating videos.
+     * Only V2.6 and subsequent versions support this parameter,
+     * and requires `mode: 'pro'`.
+     */
+    sound?: 'on' | 'off' | null;
+    /**
+     * Flexibility in video generation. The higher the value, the lower the
+     * model's flexibility, and the stronger the relevance to the user's prompt.
+     * Value range: [0, 1]. Kling-v2.x models do not support this parameter.
+     */
+    cfgScale?: number | null;
+    /**
+     * Camera movement control. If not specified, the model will intelligently
+     * match based on the input text/images.
+     */
+    cameraControl?: {
+        type: 'simple' | 'down_back' | 'forward_up' | 'right_turn_forward' | 'left_turn_forward';
+        config?: {
+            horizontal?: number | null;
+            vertical?: number | null;
+            pan?: number | null;
+            tilt?: number | null;
+            roll?: number | null;
+            zoom?: number | null;
+        } | null;
+    } | null;
+    /**
+     * End frame image for I2V start+end frame control.
+     * Supports image URL or raw base64-encoded image data.
+     * Requires `mode: 'pro'` for most models.
+     */
+    imageTail?: string | null;
+    /**
+     * Static brush mask image for I2V motion brush.
+     * Supports image URL or raw base64-encoded image data.
+     */
+    staticMask?: string | null;
+    /**
+     * Dynamic brush configurations for I2V motion brush.
+     * Up to 6 groups, each with a mask and motion trajectories.
+     */
+    dynamicMasks?: Array<{
+        mask: string;
+        trajectories: Array<{
+            x: number;
+            y: number;
+        }>;
+    }> | null;
+    /**
+     * Enable multi-shot video generation (Kling v3.0+).
+     * When true, the video is split into up to 6 storyboard shots
+     * with individual prompts and durations.
+     *
+     * When multiShot is true with shotType 'customize', multiPrompt is required.
+     * When multiShot is true, the main prompt parameter is ignored by the API.
+     */
+    multiShot?: boolean | null;
+    /**
+     * Storyboard method for multi-shot video generation (Kling v3.0+).
+     * Required when multiShot is true.
+     *
+     * - `'customize'`: User-defined shots via multiPrompt.
+     * - `'intelligence'`: Model auto-segments based on the main prompt.
+     */
+    shotType?: 'customize' | 'intelligence' | null;
+    /**
+     * Per-shot details for multi-shot video generation (Kling v3.0+).
+     * Required when multiShot is true and shotType is 'customize'.
+     *
+     * Up to 6 shots. Each shot has an index, prompt (max 512 chars),
+     * and duration in seconds. Shot durations must sum to the total duration.
+     */
+    multiPrompt?: Array<{
+        index: number;
+        prompt: string;
+        duration: string;
+    }> | null;
+    /**
+     * Reference elements for element control (Kling v3.0+).
+     * Supports video character elements and multi-image elements.
+     *
+     * - I2V: Up to 3 reference elements. Cannot coexist with voiceList.
+     * - Motion Control: Currently only 1 element supported.
+     *   When referencing an element, the generated video can only
+     *   refer to the orientation of the person in the video.
+     */
+    elementList?: Array<{
+        element_id: number;
+    }> | null;
+    /**
+     * Voice references for voice control (Kling v3.0+).
+     * Up to 2 voice references. Referenced via `<<<voice_1>>>` template
+     * syntax in the prompt.
+     *
+     * When voiceList is used and the prompt references voice IDs,
+     * sound must be set to 'on'.
+     * Cannot coexist with elementList on the I2V endpoint.
+     */
+    voiceList?: Array<{
+        voice_id: string;
+    }> | null;
+    /**
+     * Whether to generate watermarked results simultaneously.
+     */
+    watermarkEnabled?: boolean | null;
+    /**
+     * URL of the reference video. The character actions in the generated video
+     * are consistent with the reference video.
+     *
+     * Supports .mp4/.mov, max 100MB, side lengths 340px–3850px,
+     * duration 3–30 seconds (depends on `characterOrientation`).
+     */
+    videoUrl?: string | null;
+    /**
+     * Orientation of the characters in the generated video.
+     *
+     * - `'image'`: Same orientation as the person in the image.
+     *   Reference video duration max 10 seconds.
+     * - `'video'`: Same orientation as the person in the video.
+     *   Reference video duration max 30 seconds.
+     */
+    characterOrientation?: 'image' | 'video' | null;
+    /**
+     * Whether to keep the original sound of the reference video.
+     * Default: `'yes'`.
+     */
+    keepOriginalSound?: 'yes' | 'no' | null;
+    [key: string]: unknown;
+};
+
+export { type KlingAIProvider, type KlingAIProviderSettings, type KlingAIVideoModelId, type KlingAIVideoModelOptions, type KlingAIVideoModelOptions as KlingAIVideoProviderOptions, createKlingAI, klingai };