POST
/
kling
/
v1
/
videos
/
text2video
Kling 文生视频
curl --request POST \
  --url https://vip.xmsmartlink.com/kling/v1/videos/text2video \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model_name": "2.1",
  "prompt": "银色无人机穿过雨夜霓虹巷道,镜头平稳推进。",
  "duration": 5,
  "aspect_ratio": "16:9",
  "mode": "std",
  "sound": "on"
}
'
{
  "code": 0,
  "message": "",
  "task_id": "task_xxxxxxxxxxxxxxxx"
}

Authorizations

Authorization
string
header
required

使用 Authorization: Bearer <YOUR_API_KEY> 进行认证。

Body

application/json
model_name
string
required

Kling 模型名称,例如 kling-v1-6、kling-v2-1、kling-v2-6、kling-v3。

prompt
string
required

提示词,最长 2500 字符。

negative_prompt
string

负向提示词,最长 2500 字符。

duration

视频时长。

aspect_ratio
string

视频比例,例如 16:9、9:16、1:1,默认 16:9。

mode
enum<string>

生成模式:std 标准模式或 pro 专家模式。

Available options:
std,
pro
sound
enum<string>

是否生成声音:on 或 off。

Available options:
on,
off
cfg_scale
number

模型自由度,取值范围 [0, 1],默认 0.5。

watermark_info
object

Kling 水印控制对象。

multi_shot

是否启用智能分镜;也可传 intelligence 或 customize。

shot_type
string

分镜类型,可传 intelligence 或 customize;multi_shot=true 时通常必填。

multi_prompt
object[]

自定义分镜提示词列表,最多 6 个分镜。

callback_url
string

任务状态回调地址。

external_task_id
string

外部任务 ID。

Response

Kling 任务创建响应。

code
integer
message
string
task_id
string
request_id
string
data
object