可灵视频生成 — 创建任务

POST

/services/aigc/video-generation/video-synthesis

curl --location 'https://dashscope.aliyuncs.com/api/v1/services/aigc/video-generation/video-synthesis' \
    -H 'X-DashScope-Async: enable' \
    -H "Authorization: Bearer $DASHSCOPE_API_KEY" \
    -H 'Content-Type: application/json' \
    -d '{
    "model": "kling/kling-v3-video-generation",
    "input": {
        "prompt": "一只小猫在月光下奔跑"
    },
    "parameters": {
        "mode": "std",
        "aspect_ratio": "16:9",
        "duration": 5,
        "audio": false,
        "watermark": true
    }
}'

{
  "code": "InvalidApiKey",
  "message": "No API-key provided.",
  "request_id": "7438d53d-6eb8-4596-8835-xxxxxx"
}

可灵视频生成模型支持文本、图片和视频素材输入，可生成最长 15 秒、最高 1080P 分辨率的视频。

文生视频：输入文字提示词生成视频，支持智能分镜（由模型自动规划多镜头叙事）和自定义分镜。
图生视频（首帧）：以图片作为视频首帧驱动视频生成。
图生视频（首尾帧）：同时指定首帧和尾帧，模型生成中间过渡内容。
参考生视频：以参考图像、视频素材为主体，结合提示词生成新视频，支持多主体组合。

所有视频生成接口均为异步接口。提交任务后，使用返回的 task_id 轮询查询接口获取结果。

鉴权

string

header

必填

千问云 API Key。详见获取 API Key。

Header 参数

enum<string>

必填

固定填 enable，启用异步模式。

可选值：enable

请求体

application/json

enum<string>

必填

模型 ID。kling-v3-omni-video-generation 支持图生视频（首帧/首尾帧）、参考生视频等所有模式；kling-v3-video-generation 支持文生视频和多镜头叙事。

可选值：kling/kling-v3-omni-video-generation,kling/kling-v3-video-generation

object

必填

任务输入参数。

显示子属性

string

视频描述提示词，最多 2500 个字符。使用 omni 模型的参考生视频模式时，可通过 <<<element_1>>>、<<<image_1>>>、<<<video_1>>> 语法引用 element_list 和 media 中的素材。shot_type=intelligence 时必填；shot_type=customize 时不使用本字段。

取值范围：length <= 2500

object[]

输入媒体列表。kling-v3-video-generation 仅支持 first_frame、last_frame；kling-v3-omni-video-generation 额外支持 refer、base、feature。

显示子属性

enum<string>

必填

媒体类型。first_frame：图生视频首帧；last_frame：图生视频尾帧；refer：参考图像；base：参考视频（omni 模型）；feature：特征参考视频（omni 模型）。

可选值：first_frame,last_frame,refer,base,feature

string

必填

媒体文件的公网 URL。

enum<string>

默认值"no"

是否保留原视频音频，仅 omni 模型且 type 为 base 或 feature 时有效。yes：保留；no（默认）：不保留。

可选值：yes,no

boolean

默认值false

是否启用多镜头模式。启用时须指定 shot_type。

enum<string>

多镜头分镜策略，multi_shot=true 时必填。intelligence：由模型自动规划分镜；customize：按 multi_prompt 自定义分镜。

可选值：intelligence,customize

object[]

自定义多镜头提示词列表，shot_type=customize 时必填。最多 6 个镜头，index 从 1 开始。

取值范围：items <= 6

显示子属性

integer

必填

镜头编号，从 1 开始。

取值范围：1 <= x <= 6

string

必填

该镜头的描述提示词，最多 512 个字符。

取值范围：length <= 512

integer

必填

该镜头时长（秒），须 ≥ 1 且 ≤ parameters.duration。

取值范围：x >= 1

object[]

元素列表，用于参考生视频模式。

显示子属性

integer

必填

元素 ID。

object

生成参数。

显示子属性

enum<string>

默认值"pro"

生成模式。pro（默认）：专业模式，输出 1080P；std：标准模式，输出 720P。

可选值：pro,std

enum<string>

默认值"16:9"

视频宽高比。文生视频和参考生视频（refer/feature）模式必填；图生视频（首帧/首尾帧）模式自动继承输入图像比例。

可选值：16:9,9:16,1:1

integer

默认值5

视频时长（秒），默认 5 秒，范围 3–15。使用 omni 模型且输入含 base 或 feature 类型视频时，范围为 3–10。

取值范围：3 <= x <= 15

boolean

默认值false

是否自动生成配音，默认 false。注意：当传入视频（type 为 base 或 feature）时，audio 只能设置为 false。

boolean

默认值false

是否在视频上添加水印，默认 false。

响应

4XX-application/json

string

错误码。

string

错误信息。

string

请求唯一标识符。