图生视频

请求可提交首帧、可选尾帧和生成参数。

POST/kling/v1/videos/image2video

使用首帧图片和可选尾帧创建 Kling 原生图生视频任务。

Authorization

bearerAuth

AuthorizationBearer <token>

在 Authorization Header 中使用 Bearer your-api-key。

In: header

Request Body

application/json

Kling 原生图生视频请求。

TypeScript Definitions

Use the request body type in TypeScript.

model*string

Kling 原生模型 ID，例如 kling-v2-5-turbo 和 kling-v2-6。实际可用模型以当前 API Key 返回的模型列表为准。

Length1 <= length

prompt*string

正向提示词，不超过 2500 个字符。

Lengthlength <= 2500

negative_prompt?string

负向提示词。

Lengthlength <= 2500

init_image*string

图生视频的首帧图片 URL，图生视频时必填。

Length1 <= length

image_tail?string

可选尾帧图片 URL。使用尾帧时必须设置 mode=pro；kling-v2-6 在 std 模式下传入该字段会返回 1201。

mode?string

生成模式。使用 image_tail 时必须为 pro。

Value in

"std"
"pro"

aspect_ratio?string

输出画面比例。

Default"16:9"

Value in

"16:9"
"9:16"
"1:1"

duration_string?string

视频时长，单位为秒。

Value in

"5"
"10"

cfg_scale?number

提示词一致性强度。

Range0 <= value <= 1

sound?string

是否生成声音。仅 V2.6 及后续模型支持。

Value in

"on"
"off"

voice_list?array<>

引用音色列表。

Itemsitems <= 2

callback?string

任务状态回调地址。

Formaturi

params?string

回调透传参数。

Response Body

`application/json`

curl -X POST "https://example.com/kling/v1/videos/image2video" \  -H "Content-Type: application/json" \  -d '{    "model": "MODEL_ID",    "prompt": "保持主体风格不变，让角色缓慢走向镜头",    "negative_prompt": "模糊，低清晰度",    "init_image": "https://example.com/input-image.jpg",    "image_tail": "https://example.com/end-frame.jpg",    "mode": "pro",    "aspect_ratio": "16:9",    "duration_string": "10",    "cfg_scale": 0.6,    "sound": "on",    "callback": "https://example.com/kling/callback",    "params": "user_id_123"  }'

{
  "code": 0,
  "message": "SUCCEED",
  "request_id": "REQUEST_ID",
  "data": {
    "task_id": "task_id_here",
    "task_status": "submitted",
    "created_at": 1640995200000,
    "updated_at": 1640995200000
  }
}

Authorization

Request Body

Response Body

200application/json

400application/json

401application/json

`application/json`

`application/json`

`application/json`