典名词元典名词元首页
API 文档
AI 模型接口视频可灵

3.0 文生视频

POST
/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

duration?string

生成视频时长,单位s ● 枚举值:3,4,5,6,7,8,9,10,11,12,13,14,15 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

prompt?string

文本提示词,可包含正向描述和负向描述 ● 可将提示词模板化来满足不同的视频生成需求 Omni模型可通过Prompt与主体、图片、视频等内容实现多种能力 ○ 通过<<<>>>的格式来指定某个主体、图片、视频,如:<<<element_1>>>、<<<image_1>>>、<<<video_1>>> ● 长度不能超过2500个字符 ● 当multi_shot参数为false时,当前参数不得为空 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

_action*string

固定值k3_t2v

multi_shot?boolean

是否生成多镜头视频 ● 当前参数为true时,prompt参数无效 ● 当前参数为false时,shot_type参数及multi_prompt参数无效

shot_type?string

分镜方式 ● 枚举值:customize ● 当multi_shot参数为true时,当前参数必填

multi_prompt?array<string>

各分镜信息,如提示词、时长等 ● 通过index、prompt、duration参数定义分镜序号及相应提示词和时长,其中: ○ 最多支持6个分镜,最小支持1个分镜 ○ 每个分镜相关内容的最大长度不超过512 ○ 每个分镜的时长不大于当前任务的总时长,不小于1 ○ 所有分镜的时长之和等于当前任务的总时长 ● 用key:value承载,如下:"multi_prompt": [ { "index":int, "prompt": "string", "duration": "5" }, { "index":int, "prompt": "string", "duration": "5" } ] ● 当mult_shot参数为true且shot_type参数为customize时,当前参数不得为空

sound?string

生成视频时是否同时生成声音 ● 枚举值:on,off ● 仅V2.6及后续版本模型支持当前参数

watermark_info?array<string>

是否同时生成含水印的结果 ● 通过enabled参数定义,具体array格式如下:"watermark_info": { "enabled": boolean // true 为生成,false 为不生成} ● 暂不支持自定义水印

negative_prompt?string

负向文本提示词 ● 不能超过2500个字符

cfg_scale?string

生成视频的自由度;值越大,模型自由度越小,与用户输入的提示词相关性越强 ● 取值范围:[0, 1] ● kling-v2.x模型不支持当前参数

mode?string

生成视频的模式 ● 枚举值:std,pro ● 其中std:标准模式(标准),基础模式,性价比高 ● 其中pro:专家模式(高品质),高表现模式,生成视频质量更佳 ● 不同模型版本、视频模式支持范围不同,详见当前文档能力地图

aspect_ratio?string

生成视频的画面纵横比(宽:高) ● 枚举值:16:9, 9:16, 1:1

model*string

模型名称: kling-v3

Response Body

application/json

curl -X POST "https://api.aa.com.cn/api/v1/video/generation" \  -H "Authorization: string" \  -H "Content-Type: application/json" \  -d '{    "_action": "string",    "model": "string"  }'
{
  "code": 0,
  "data": {
    "urls": [
      "string"
    ],
    "usage": {
      "images": 0,
      "seconds": 0,
      "input_tokens": 0,
      "total_tokens": 0,
      "output_tokens": 0
    },
    "expired": "string",
    "task_id": "string",
    "task_status": "string"
  },
  "message": "string",
  "request_id": "string"
}