文生视频

使用 /kling/v1/videos/text2video 创建可灵文生视频任务，并查询单个任务或任务列表。

文生视频适用于 Kling 3.0 & 3.0 Omni、Kling 2.6、Kling 2.5 Turbo、Kling 2.1 Master、Kling 2.0 Master、Kling 1.6 和 Kling 1.0。Kling 3.0 Turbo 请使用 Kling 3.0 Turbo 任务接口。

创建任务

请求方式	路径
`POST`	`/kling/v1/videos/text2video`

请求头

Content-Type: application/json
Authorization: Bearer {apikey}

请求体要点

字段	说明
`model_name`	可灵模型名，例如 `kling-v3`, `kling-v2-6`, `kling-v1-6`
`prompt`	正向提示词
`negative_prompt`	负向提示词，可选
`cfg_scale`	提示词相关性，可选
`mode`	生成模式，按模型支持范围填写
`duration`	视频时长，按模型支持范围填写
`aspect_ratio`	画面比例
`callback_url`	任务状态回调地址，可选

cURL

curl --location "$KLING_BASE_URL/kling/v1/videos/text2video" \
  --header "Content-Type: application/json" \
  --header "Authorization: Bearer $KLING_API_KEY" \
  --data '{
    "model_name": "kling-v2-6",
    "prompt": "一只猫在雨夜的霓虹街道上奔跑，电影感镜头",
    "negative_prompt": "模糊，低清晰度",
    "duration": "5",
    "aspect_ratio": "16:9"
  }'

查询任务（单个）

请求方式	路径
`GET`	`/kling/v1/videos/text2video/{id}`

curl "$KLING_BASE_URL/kling/v1/videos/text2video/{id}" \
  --header "Authorization: Bearer $KLING_API_KEY"

查询任务（列表）

请求方式	路径
`GET`	`/kling/v1/videos/text2video?pageNum=1&pageSize=30`

curl "$KLING_BASE_URL/kling/v1/videos/text2video?pageNum=1&pageSize=30" \
  --header "Authorization: Bearer $KLING_API_KEY"