Kling 图生视频 - xmsmartlink Docs

curl --request POST \ --url https://vip.xmsmartlink.com/kling/v1/videos/image2video \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "model_name": "kling-v3", "prompt": "图中女孩对着镜头说\"茄子\"，360度环绕运镜", "image": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_first_frame.jpeg", "duration": 5, "aspect_ratio": "16:9", "mode": "std", "image_tail": "https://ark-project.tos-cn-beijing.volces.com/doc_image/seepro_last_frame.jpeg", "sound": "on" } '

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

提示词；除自定义多镜头外通常必填。

image

string

首帧图片 URL 或 Base64；与 image_tail 至少传一个。

image_tail

string

尾帧图片 URL 或 Base64；与 image 至少传一个。

negative_prompt

string

负向提示词。

element_list

object[]

参考主体列表，最多 3 个。

Show child attributes

voice_list

object[]

引用音色列表，最多 2 个；与 element_list 互斥。

sound

enum<string>

是否生成声音：on 或 off。

Available options:

on,

off

mode

enum<string>

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

Available options:

std,

pro

duration

视频时长。

aspect_ratio

string

视频比例。

multi_shot

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

shot_type

string

分镜类型，可传 intelligence 或 customize。

multi_prompt

object[]

自定义分镜提示词列表。

Show child attributes

cfg_scale

number

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

static_mask

静态遮罩。

dynamic_masks

object[]

动态遮罩序列，用于局部区域运动控制。

Show child attributes

camera_control

object

镜头控制对象，会按官方字段名透传给上游。

watermark_info

object

Kling 水印控制对象。

Show child attributes

callback_url

string

任务状态回调地址。

external_task_id

string

外部任务 ID。

Response

Kling 任务创建响应。

code

integer

message

string

task_id

string

request_id

string

data

object