Skip to content

可灵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

参数名类型必填说明
modelstring必需模型 ID。指定使用的视频生成模型版本。
promptstring必需提示词。描述期望生成的视频内容、动作和场景。
sizestring必需尺寸。
modestring必需模式。
durationinteger必需视频时长。生成视频的持续时间(通常以秒为单位)。
resolutionstring必需分辨率。视频的清晰度规格(例如 "1024x576", "720p")。
fpsinteger必需帧率。每秒显示的帧数,影响视频的流畅度。
style_presetstring必需风格预设。预定义的视觉风格标签(例如 "cinematic", "anime", "3d-model")。
aspect_ratiostring必需宽高比。视频画面的比例(例如 "16:9", "9:16")。
guidance_scaleinteger必需引导系数。控制模型对提示词的遵循程度,值越高越贴合提示词但可能降低多样性。
response_formatstring必需响应格式。指定返回数据的格式(如 "mp4", "gif" 或数据编码格式)。
num_variationsinteger必需变体数量。一次性生成的视频版本数量,便于用户从中挑选最佳结果。

请求示例 (JSON)

{
    "model": "kling-video-o1",
    "prompt": "一只可爱的橘猫在阳光下奔跑,慢镜头,电影质感",
    "size": "1920x1080",
    "mode": "pro"
}

返回响应

200 成功

Content-Type: application/json

响应参数

字段名类型必填说明
createdinteger必需创建时间戳。该图像生成任务完成时的 Unix 时间戳。
dataarray [object]必需数据数组。包含实际生成结果的数组(通常包含一个或多个图片对象)。
├─ urlstring必需图片链接。生成的图像文件的访问地址(通常在 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"))