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

图生视频

POST
/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

duration?integer

视频时长,单位 s,支持:5、10

image*

图片信息,单图生视频时必填。包含 imageUrl 字段(图片 URL,需公网可访问)。

图片文件大小不超过 10MB

格式支持 .jpg/.jpeg/.png

宽高不小于 300px,宽高比在 1:2.5 ~ 2.5:1 之间

prompt*string

提示词,最大长度 2500 字符

resolution?string

视频分辨率(仅 kling-v1-6 支持),支持:360p、540p、720p、1080p

model*string

模型名称, 支持:

kling-v1-6

kling-v2

kling-v2-1

kling-v2-1-master

kling-v2-5-turbo

kling-v2-6

_action*string

固定值i2v

headtailImages*

首尾帧图片信息,首尾帧生视频时必填(kling-v2、kling-v2-1、kling-v2-1-master 不支持)。

包含 headImage.imageUrl(首帧图片)和 tailImage.imageUrl(尾帧图片)

negativePrompt?string

负面提示词,用于描述不希望在画面中出现的内容

motionMode?string

生成模式(仅 kling-v1-6 支持),默认 std,支持:std、pro

characterImages*

参考图片信息,参考生视频时必填(仅 kling-v1-6 支持,最大支持 4 张图片)。每个元素包含 imageUrl 字段

cfgScale?number

自由度,默认 0.5,取值范围 [0, 1],值越大模型自由度越小,与提示词相关性越强

aspectRatio?string

画面比例(仅 kling-v1-6 参考生支持),默认 16:9,支持:16:9、9:16、1:1

mode?string

模式(kling-v2-5-turbo、kling-v2-6 支持)

kling-v2-5-turbo 默认 std

kling-v2-6 默认 pro,支持:std、pro(首尾帧生视频时 kling-v2-5-turbo 仅支持 pro 模式)

sound?string

声音开关(仅 kling-v2-6 支持),默认 off,支持:off、on

voice?string

音色开关(仅 kling-v2-6 支持),默认 off,支持:off、on

voiceList?array<string>

音色列表(仅 kling-v2-6 支持),一次视频生成任务至多引用 2 个音色

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 '{    "image": {      "imageUrl": "string"    },    "prompt": "string",    "model": "string",    "_action": "string",    "headtailImages": {},    "characterImages": [      {        "imageUrl": "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"
}