Skip to main content

创建任务

POST /kling/v1/videos/text2video使用 model_name: "kling-3.0" 根据文本提示词生成视频。支持多镜头分镜、运镜、音效与音色引用。
cURL
200

请求头

string
必填
Bearer 身份验证,格式为 Bearer YOUR_API_KEY
string
默认值:"application/json"
必填
请求数据格式,固定为 application/json

请求参数

string
必填
模型名称。Kling 3.0 文生视频固定为 kling-3.0
string
正向提示词,最长 2500 字符。单镜头,或 shot_typeintelligence 时必填。
string
不希望出现在视频中的内容,最长 2500 字符。
boolean
默认值:false
是否生成多镜头视频。
string
multi_shottrue 时必填。可选 customizeintelligence
object[]
自定义分镜列表,支持 1–6 个分镜。每项包含 indexpromptduration
object[]
音色引用列表,最多 2 个,每项包含 voice_id
string
默认值:"off"
是否生成同步音效,可选 onoff。引用音色时必须设为 on
string
默认值:"std"
输出模式:std 为 720p,pro 为 1080p,4k 为 4K。
string
默认值:"5"
视频时长,可选 3–15 秒。
string
默认值:"16:9"
画面比例,可选 16:99:161:1
number
提示词相关性,范围 0–1。
object
预设或自定义运镜配置。
object
平台水印配置,通过 enabled 控制是否添加水印。

多镜头与音色

  • multi_shot: true 时必须设置 shot_typecustomize 使用 multi_promptintelligence 根据 prompt 自动生成分镜。
  • multi_prompt 支持 1–6 个分镜;每项包含 indexpromptduration,单项提示词最长 512 字符,每个分镜至少 1 秒。
  • voice_list 最多 2 个音色。按列表顺序在提示词中写入 <<<voice_1>>><<<voice_2>>>,并设置 sound: "on"
  • voice_id 来自自定义音色或预置音色接口,不要使用 Lip-Sync 接口返回的音色 ID。

运镜控制

camera_control.type 支持 simpledown_backforward_upright_turn_forwardleft_turn_forward。使用 simple 时,config 的以下六项范围均为 -10 到 10,且只能设置一个非 0 值:

交互式请求参数

在交互式 API 页面中填写并调试完整请求体。

查询任务

  • 单个任务:GET /kling/v1/videos/text2video/{task_id}。状态依次为 submittedprocessing,最终进入 succeedfailed
  • 任务列表:GET /kling/v1/videos/text2video?pageNum=1&pageSize=30pageNum 范围 1–1000,pageSize 范围 1–500。
本组接口使用可灵旧版请求结构。AnyFast 在旧版接口路径前增加 /kling 路由前缀,接口名称和请求字段保持旧版结构。