跳转到主要内容
可灵视频生成

可灵视频生成 — 创建任务

提交可灵视频生成异步任务

POST
/services/aigc/video-generation/video-synthesis
curl --location 'https://maas.qianwenaiapi.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 分辨率的视频。
  • 文生视频:输入文字提示词生成视频,支持智能分镜(由模型自动规划多镜头叙事)和自定义分镜。
  • 图生视频(首帧):以图片作为视频首帧驱动视频生成。
  • 图生视频(首尾帧):同时指定首帧和尾帧,模型生成中间过渡内容。
  • 参考生视频:以参考图像、视频素材为主体,结合提示词生成新视频,支持多主体组合。
  • 视频编辑:基于输入视频进行编辑。

模型概览

模型名称能力支持输入模态输出视频规格
kling/kling-v3-turbo-video-generation文生视频、图生视频(首帧)文本、图像分辨率:std(720P)、pro(1080P);宽高比:16:9、9:16、1:1;时长:3-15秒
kling/kling-v3-video-generation文生视频、图生视频(首帧/首尾帧)文本、图像分辨率:std(720P)、pro(1080P)、4k;宽高比:16:9、9:16、1:1;时长:3-15秒
kling/kling-v3-omni-video-generation文生视频、图生视频(首帧/首尾帧)、参考生视频、视频编辑文本、图像、视频分辨率:std(720P)、pro(1080P)、4k;宽高比:16:9、9:16、1:1;时长:3-15秒
所有视频生成接口均为异步接口。提交任务后,使用返回的 task_id 轮询查询接口获取结果。
  • Python SDK
from http import HTTPStatus
from dashscope import VideoSynthesis
import dashscope
import os

# 若没有配置环境变量,请用千问AI平台API Key将下行替换为:api_key="sk-xxx"
# 获取API Key:https://platform.qianwenai.com/home/api-keys
api_key = os.getenv("DASHSCOPE_API_KEY")

def sample_async_call():
    # 异步提交视频生成任务
    rsp = VideoSynthesis.async_call(api_key=api_key,
                                model='kling/kling-v3-turbo-video-generation',
                                prompt='一只小猫在月光下奔跑',
                                mode='std',
                                aspect_ratio='16:9',
                                duration=5,
                                audio=False,
                                watermark=True)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print("task_id: %s" % rsp.output.task_id)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

    # 查询任务状态
    status = VideoSynthesis.fetch(task=rsp, api_key=api_key)
    if status.status_code == HTTPStatus.OK:
        print(status.output.task_status)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (status.status_code, status.code, status.message))

    # 等待任务完成
    rsp = VideoSynthesis.wait(task=rsp, api_key=api_key)
    print(rsp)
    if rsp.status_code == HTTPStatus.OK:
        print(rsp.output.video_url)
    else:
        print('Failed, status_code: %s, code: %s, message: %s' %
              (rsp.status_code, rsp.code, rsp.message))

if __name__ == '__main__':
    sample_async_call()

鉴权

string
header
必填

千问AI平台 API Key。详见获取 API Key。

Header 参数

enum<string>
必填

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

enable

请求体

application/json
enum<string>
必填

模型 ID。kling/kling-v3-turbo-video-generation 支持文生视频和图生视频(首帧);kling/kling-v3-video-generation 支持文生视频、图生视频(首帧/首尾帧)和多镜头叙事;kling/kling-v3-omni-video-generation 支持所有模式,包括参考生视频和视频编辑。

kling/kling-v3-turbo-video-generation,kling/kling-v3-video-generation,kling/kling-v3-omni-video-generation
object
必填

任务输入参数。

object

生成参数。

响应

4XX-application/json
string

错误码。

string

错误信息。

string

请求唯一标识符。