kling-video

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Kling Video Generation

Kling视频生成

Generate AI videos through AceDataCloud's Kuaishou Kling API.

Setup: See authentication for token setup.

通过AceDataCloud的快手Kling API生成AI视频。

设置： 查看身份验证了解令牌设置方法。

Quick Start

快速开始

bash

curl -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v3", "mode": "std", "duration": 5}'

Async: See async task polling. Poll via
POST /kling/tasks
with
{"id": "..."}
.

bash

curl -X POST https://api.acedata.cloud/kling/videos \
  -H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "text2video", "prompt": "a cat playing piano on a rooftop at sunset", "model": "kling-v3", "mode": "std", "duration": 5}'

异步处理： 查看异步任务轮询。通过
POST /kling/tasks
接口并传入
{"id": "..."}
进行轮询。

Models

模型

Model	Quality	Best For
`kling-v3`	Latest	Best quality, flexible 3–15s duration, optional audio generation
`kling-v3-omni`	Latest	Omni model with audio support, flexible 3–15s duration
`kling-v2-6`	High	High-quality output with optional audio (pro mode)
`kling-v2-5-turbo`	High + Fast	Best speed/quality trade-off
`kling-v2-master`	High	High-quality output
`kling-v2-1-master`	High	Improved v2
`kling-v1-6`	Improved	Better quality than v1
`kling-v1`	Standard	Basic generation, lowest cost
`kling-video-o1`	Premium	Highest quality (thinking model)

模型	画质	适用场景
`kling-v3`	最新版本	最佳画质，支持3–15秒灵活时长，可选音频生成
`kling-v3-omni`	最新版本	支持音频的全能模型，支持3–15秒灵活时长
`kling-v2-6`	高质量	高质量输出，可选音频（pro模式）
`kling-v2-5-turbo`	高质量+快速	速度与画质的最佳平衡
`kling-v2-master`	高质量	高质量输出
`kling-v2-1-master`	高质量	v2版本的改进版
`kling-v1-6`	改进版	画质优于v1版本
`kling-v1`	标准	基础生成能力，成本最低
`kling-video-o1`	高端	最高画质（智能模型）

Quality Modes

画质模式

Mode	Speed	Cost	Use For
`std` (Standard)	Slower	Lower	Draft/preview
`pro` (Professional)	Faster	Higher	Final output
`4k` (Native 4K)	—	Premium	Native 4K output — only `kling-v3` and `kling-v3-omni` ; incompatible with `camera_control`

模式	速度	成本	适用场景
`std` （标准）	较慢	较低	草稿/预览
`pro` （专业）	较快	较高	最终输出
`4k` （原生4K）	—	高端	原生4K输出 — 仅支持 `kling-v3` 和 `kling-v3-omni` ；与 `camera_control` 不兼容

Workflows

工作流

1. Text-to-Video

1. 文本转视频

json

POST /kling/videos
{
  "action": "text2video",
  "prompt": "a futuristic city with flying cars",
  "model": "kling-v3",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

json

POST /kling/videos
{
  "action": "text2video",
  "prompt": "a futuristic city with flying cars",
  "model": "kling-v3",
  "mode": "std",
  "duration": 5,
  "aspect_ratio": "16:9"
}

2. Image-to-Video

2. 图像转视频

Animate a still image. Optionally specify an ending frame.

json

POST /kling/videos
{
  "action": "image2video",
  "prompt": "the scene slowly comes alive with movement",
  "start_image_url": "https://example.com/scene.jpg",
  "end_image_url": "https://example.com/end-scene.jpg",
  "model": "kling-v3",
  "mode": "pro"
}

将静态图像动画化。可选择指定结束帧。

json

POST /kling/videos
{
  "action": "image2video",
  "prompt": "the scene slowly comes alive with movement",
  "start_image_url": "https://example.com/scene.jpg",
  "end_image_url": "https://example.com/end-scene.jpg",
  "model": "kling-v3",
  "mode": "pro"
}

3. Extend Video

3. 视频扩展

Continue an existing video with additional seconds.

json

POST /kling/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera pulls back to reveal the full landscape",
  "model": "kling-v2-5-turbo"
}

为现有视频添加额外时长，继续生成内容。

json

POST /kling/videos
{
  "action": "extend",
  "video_id": "existing-video-id",
  "prompt": "the camera pulls back to reveal the full landscape",
  "model": "kling-v2-5-turbo"
}

4. Motion Control

4. 运动控制

Apply precise camera/motion control from an image + reference video.

json

POST /kling/motion
{
  "image_url": "https://example.com/subject.jpg",
  "video_url": "https://example.com/motion-reference.mp4"
}

通过图像+参考视频实现精准的相机/运动控制。

json

POST /kling/motion
{
  "image_url": "https://example.com/subject.jpg",
  "video_url": "https://example.com/motion-reference.mp4"
}

5. Lip Sync

5. 唇形同步

Create a lip-synced video from a source video plus either an audio track or input text.

json

POST /kling/lip-sync
{
  "video_url": "https://example.com/source.mp4",
  "mode": "audio2video",
  "audio_url": "https://example.com/voiceover.mp3"
}

从源视频加上音频轨道或输入文本，生成唇形同步的视频。

json

POST /kling/lip-sync
{
  "video_url": "https://example.com/source.mp4",
  "mode": "audio2video",
  "audio_url": "https://example.com/voiceover.mp3"
}

6. Talking Photo

6. 对话照片

Animate a still portrait from an image plus an audio track.

json

POST /kling/talking-photo
{
  "image_url": "https://example.com/portrait.jpg",
  "audio_url": "https://example.com/voiceover.mp3",
  "model": "kling-v2-1-master",
  "duration": 5,
  "mode": "pro"
}

从图像加上音频轨道，将静态肖像动画化。

json

POST /kling/talking-photo
{
  "image_url": "https://example.com/portrait.jpg",
  "audio_url": "https://example.com/voiceover.mp3",
  "model": "kling-v2-1-master",
  "duration": 5,
  "mode": "pro"
}

Parameters

参数说明

Parameter	Values	Description
`action`	`"text2video"` , `"image2video"` , `"extend"`	Generation mode
`model`	See models table	Model to use
`mode`	`"std"` , `"pro"` , `"4k"`	Quality mode ( `4k` only for `kling-v3` / `kling-v3-omni` , incompatible with `camera_control` )
`duration`	`5` , `10` (v3/v3-omni: `3` – `15` )	Duration in seconds
`generate_audio`	`true` , `false`	Generate audio with video (v3, v3-omni, v2-6 pro only)
`aspect_ratio`	`"16:9"` , `"9:16"` , `"1:1"`	Video aspect ratio
`cfg_scale`	0–1	Prompt relevance strength
`negative_prompt`	string	What to avoid in the video
`camera_control`	object	Camera movement parameters
`element_list`	array	Reference subjects from the element library (each item has `element_id` ). Combined with `video_list` , total reference images + subjects ≤ 7 (or ≤ 4 if a reference video is included)
`video_list`	array	Reference video(s) via `video_url` (MP4/MOV, 3–10s, ≤200MB, max 1 video). Each item has `video_url` , `refer_type` ( `"feature"` or `"base"` ), and optional `keep_original_sound`
`callback_url`	string	Async callback URL
`mode` ( `/kling/lip-sync` )	`"audio2video"` , `"text2video"`	Lip-sync mode
`video_url` ( `/kling/lip-sync` )	URL	Source video URL for lip-sync
`video_id` ( `/kling/lip-sync` )	string	Existing Kling video ID for lip-sync
`audio_url` ( `/kling/lip-sync` )	URL	Audio source URL (for `audio2video` )
`audio_type` ( `/kling/lip-sync` )	`"url"` , `"file"`	Audio input type (default `url` )
`audio_file` ( `/kling/lip-sync` )	string	Audio file payload when `audio_type=file`
`text` ( `/kling/lip-sync` )	string	Input text to synthesize speech (for `text2video` )
`voice_id` ( `/kling/lip-sync` )	string	Voice preset ID used in `text2video`
`voice_language` ( `/kling/lip-sync` )	`"zh"` , `"en"`	TTS language for `text2video` (default `zh` )
`voice_speed` ( `/kling/lip-sync` )	number	TTS speaking speed (default `1.0` )
`image_url` ( `/kling/talking-photo` )	URL	Source portrait image
`audio_url` ( `/kling/talking-photo` )	URL	Driving audio track
`model` ( `/kling/talking-photo` )	`"kling-v1"` , `"kling-v1-6"` , `"kling-v2-master"` , `"kling-v2-1-master"` , `"kling-v2-5-turbo"` , `"kling-v2-6"`	Talking-photo model
`duration` ( `/kling/talking-photo` )	`5` , `10`	Talking-photo duration
`mode` ( `/kling/talking-photo` )	`"std"` , `"pro"`	Talking-photo quality mode

参数	取值	说明
`action`	`"text2video"` , `"image2video"` , `"extend"`	生成模式
`model`	见模型表格	使用的模型
`mode`	`"std"` , `"pro"` , `"4k"`	画质模式（ `4k` 仅支持 `kling-v3` / `kling-v3-omni` ，与 `camera_control` 不兼容）
`duration`	`5` , `10` （v3/v3-omni： `3` – `15` ）	视频时长（秒）
`generate_audio`	`true` , `false`	随视频生成音频（仅v3、v3-omni、v2-6的pro模式支持）
`aspect_ratio`	`"16:9"` , `"9:16"` , `"1:1"`	视频宽高比
`cfg_scale`	0–1	提示词关联强度
`negative_prompt`	字符串	视频中需要避免的内容
`camera_control`	对象	相机运动参数
`element_list`	数组	元素库中的参考主体（每个条目包含 `element_id` ）。与 `video_list` 组合后，参考图像+主体总数≤7（若包含参考视频则≤4）
`video_list`	数组	通过 `video_url` 传入的参考视频（MP4/MOV格式，3–10秒，≤200MB，最多1个视频）。每个条目包含 `video_url` 、 `refer_type` （ `"feature"` 或 `"base"` ），可选 `keep_original_sound`
`callback_url`	字符串	异步回调URL
`mode` （ `/kling/lip-sync` ）	`"audio2video"` , `"text2video"`	唇形同步模式
`video_url` （ `/kling/lip-sync` ）	URL	用于唇形同步的源视频URL
`video_id` （ `/kling/lip-sync` ）	字符串	用于唇形同步的现有Kling视频ID
`audio_url` （ `/kling/lip-sync` ）	URL	音频源URL（适用于 `audio2video` 模式）
`audio_type` （ `/kling/lip-sync` ）	`"url"` , `"file"`	音频输入类型（默认 `url` ）
`audio_file` （ `/kling/lip-sync` ）	字符串	当 `audio_type=file` 时的音频文件载荷
`text` （ `/kling/lip-sync` ）	字符串	用于合成语音的输入文本（适用于 `text2video` 模式）
`voice_id` （ `/kling/lip-sync` ）	字符串	`text2video` 模式中使用的语音预设ID
`voice_language` （ `/kling/lip-sync` ）	`"zh"` , `"en"`	`text2video` 模式中的TTS语言（默认 `zh` ）
`voice_speed` （ `/kling/lip-sync` ）	数字	TTS语速（默认1.0）
`image_url` （ `/kling/talking-photo` ）	URL	源肖像图像
`audio_url` （ `/kling/talking-photo` ）	URL	驱动音频轨道
`model` （ `/kling/talking-photo` ）	`"kling-v1"` , `"kling-v1-6"` , `"kling-v2-master"` , `"kling-v2-1-master"` , `"kling-v2-5-turbo"` , `"kling-v2-6"`	对话照片模型
`duration` （ `/kling/talking-photo` ）	`5` , `10`	对话照片时长
`mode` （ `/kling/talking-photo` ）	`"std"` , `"pro"`	对话照片画质模式

Gotchas

注意事项

```
duration
```
supports
```
5
```
or
```
10
```
seconds for most models;
```
kling-v3
```
and
```
kling-v3-omni
```
support flexible
```
3
```
–
```
15
```
seconds
```
mode=4k
```
is only available for
```
kling-v3
```
and
```
kling-v3-omni
```
and is incompatible with
```
camera_control
```
```
generate_audio
```
enables synchronized audio generation (supported by
```
kling-v3
```
,
```
kling-v3-omni
```
, and
```
kling-v2-6
```
in pro mode)
```
end_image_url
```
is only for
```
image2video
```
action — it defines the last frame
Motion control (
```
/kling/motion
```
) is a separate endpoint from video generation
Lip-sync is a separate endpoint (
```
/kling/lip-sync
```
) and requires
```
mode
```
; use
```
audio_url
```
for
```
audio2video
```
or
```
text
```
+ voice fields for
```
text2video
```
Talking-photo is a separate endpoint (
```
/kling/talking-photo
```
) and requires both
```
image_url
```
and
```
audio_url
```
```
pro
```
mode costs roughly 2x
```
std
```
mode but generates faster with better quality
Task states use
```
"succeed"
```
(not "succeeded") — check for this value when polling
```
negative_prompt
```
helps avoid unwanted elements (e.g., "blurry, low quality, text")

大多数模型的
```
duration
```
支持5或10秒；
```
kling-v3
```
和
```
kling-v3-omni
```
支持3–15秒的灵活时长

mode=4k

仅适用于

kling-v3

和

kling-v3-omni

，且与

camera_control

不兼容

```
generate_audio
```
可启用同步音频生成（
```
kling-v3
```
、
```
kling-v3-omni
```
和pro模式下的
```
kling-v2-6
```
支持）
```
end_image_url
```
仅适用于
```
image2video
```
动作——用于定义最后一帧
运动控制（
```
/kling/motion
```
）是独立于视频生成的接口
唇形同步是独立接口（
```
/kling/lip-sync
```
），需要指定
```
mode
```
；
```
audio2video
```
模式使用
```
audio_url
```
，
```
text2video
```
模式使用
```
text
```
+语音相关字段
对话照片是独立接口（
```
/kling/talking-photo
```
），需要同时传入
```
image_url
```
和
```
audio_url
```
```
pro
```
模式的成本约为
```
std
```
模式的2倍，但生成速度更快、画质更好
任务状态使用
```
"succeed"
```
（而非"succeeded"）——轮询时需检查该值
```
negative_prompt
```
有助于避免不需要的元素（例如："模糊、低画质、文字"）