典名词元典名词元首页
API 文档三方工具教程
AI 模型接口视频可灵

图生视频

POST/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

_action*string

固定值i2v

model*string

模型名称, 支持:

kling-v1-6

kling-v2

kling-v2-1

kling-v2-1-master

kling-v2-5-turbo

kling-v2-6

image*object

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

图片文件大小不超过 10MB

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

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

imageUrl*string

图片链接

headtailImages*object

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

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

headImage?object

首帧图片信息

imageUrl?string

图片链接

tailImage?object

尾帧图片信息

imageUrl?string

图片链接

characterImages*array<object>

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

[]?object
imageUrl*string

图片链接

prompt*string

提示词,最大长度 2500 字符

negativePrompt?string

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

duration?integer

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

resolution?string

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

aspectRatio?string

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

cfgScale?number

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

motionMode?string

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

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 个音色

[]?string

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",    "image": {      "imageUrl": "string"    },    "headtailImages": {      "headImage": {        "imageUrl": "string"      },      "tailImage": {        "imageUrl": "string"      }    },    "characterImages": [      {        "imageUrl": "string"      }    ],    "prompt": "string",    "negativePrompt": "string",    "duration": 0,    "resolution": "string",    "aspectRatio": "string",    "cfgScale": 0,    "motionMode": "string",    "mode": "string",    "sound": "string",    "voice": "string",    "voiceList": [      "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"
}