可灵AI-文生视频kling-video-o1
POST v1/video使用 Kling 模型从文本描述生成视频。
支持的模型:kling-v2-5-turbo,kling-video-o1等
请求参数
Authorization
在 Header 添加参数 Authorization,其值为在 Bearer 之后拼接 Token。
Authorization: Bearer ******************Body 参数
Content-Type: application/json
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| model | string | 必需 | 模型 ID。指定使用的视频生成模型版本。 |
| prompt | string | 必需 | 提示词。描述期望生成的视频内容、动作和场景。 |
| size | string | 必需 | 尺寸。 |
| mode | string | 必需 | 模式。 |
| duration | integer | 必需 | 视频时长。生成视频的持续时间(通常以秒为单位)。 |
| resolution | string | 必需 | 分辨率。视频的清晰度规格(例如 "1024x576", "720p")。 |
| fps | integer | 必需 | 帧率。每秒显示的帧数,影响视频的流畅度。 |
| style_preset | string | 必需 | 风格预设。预定义的视觉风格标签(例如 "cinematic", "anime", "3d-model")。 |
| aspect_ratio | string | 必需 | 宽高比。视频画面的比例(例如 "16:9", "9:16")。 |
| guidance_scale | integer | 必需 | 引导系数。控制模型对提示词的遵循程度,值越高越贴合提示词但可能降低多样性。 |
| response_format | string | 必需 | 响应格式。指定返回数据的格式(如 "mp4", "gif" 或数据编码格式)。 |
| num_variations | integer | 必需 | 变体数量。一次性生成的视频版本数量,便于用户从中挑选最佳结果。 |
请求示例 (JSON)
{
"model": "kling-video-o1",
"prompt": "一只可爱的橘猫在阳光下奔跑,慢镜头,电影质感",
"size": "1920x1080",
"mode": "pro"
}返回响应
200 成功
Content-Type: application/json
响应参数
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| created | integer | 必需 | 创建时间戳。该图像生成任务完成时的 Unix 时间戳。 |
| data | array [object] | 必需 | 数据数组。包含实际生成结果的数组(通常包含一个或多个图片对象)。 |
| ├─ url | string | 必需 | 图片链接。生成的图像文件的访问地址(通常在 data 数组的对象内部)。 |
响应示例
{
"created": 1589478378,
"data": [
{
"url": "https://..."
},
{
"url": "https://..."
}
]
}示例代码
python
import http.client
import json
conn = http.client.HTTPSConnection("nxaiapp.com")
payload = json.dumps({
"model": "kling-video-o1",
"prompt": "一只可爱的橘猫在阳光下奔跑,慢镜头,电影质感",
"size": "1920x1080",
"mode": "pro"
})
headers = {
'Authorization': 'Bearer <token>',
'Content-Type': 'application/json'
}
conn.request("POST", "/v1/videos", payload, headers)
res = conn.getresponse()
data = res.read()
print(data.decode("utf-8"))