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

图生视频

POST
/api/v1/video/generation

Header Parameters

Authorization*string

格式: Authorization: Bearer sk-xxxxxx

Request Body

application/json

duration?integer

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

KO1模型,默认5。 枚举值:3,4,5,6,7,8,9,10,其中:使用首帧图生视频时,仅支持5和10s

image*

图片信息, 图生必填

prompt*string

提示词

resolution?string

视频分辨率(kling-v2、kling-v2-1、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6、KO1模型不支持),支持: 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模型不支持), 首尾生必填

negativePrompt?string

负面提示词(KO1模型不支持),非必填

motionMode?string

生成模式(kling-v2、kling-v2-1、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6、KO1模型不支持),非必填,默认 std,支持: std pro

characterImages*

参考图片信息(kling-v2、kling-v2-1、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6、KO1模型不支持), 参考生必填。最大支持4张图片。

cfgScale?number

自由度(KO1模型不支持),非必填,默认 0.5,取值范围:[0, 1],值越大,模型自由度越小,与用户输入的提示词相关性越强

aspectRatio?string

比例(kling-v2、kling-v2-1、kling-v2-1-master、kling-v2-5-turbo、kling-v2-6模型不支持),仅参考生支持,非必填,默认 16:9 , 支持: 16:9 9:16 1:1

KO1模型:未使用首帧生时,当前参数必填

mode?string

模式(kling-v2-5-turbo、kling-v2-6、KO1模型),非必填,默认 std,支持: std pro(首尾帧生视频、K26T模型仅支持 pro 模式)

sound?string

声音(kling-v2-6模型),非必填,默认 off,支持: off on 仅K26及后续版本模型支持当前参数

voice?string

音色(kling-v2-6模型),非必填,默认 off,支持: off on 仅K26及后续版本模型支持当前参数

voiceList?array<string>

音色列表(kling-v2-6模型),非必填,一次视频生成任务至多引用2个音色, "voice_list":[ {"voice_id":"voice_id_1"}, {"voice_id":"voice_id_2"}] 仅K26及后续版本模型支持当前参数

refImages?

参考图片信息列表(KO1模型),图片参考生必填。 包括场景、风格等参考图片,最大支持7张图片。

elements?

主体列表(KO1模型),主体参考生必填。 首帧图、参考图和主体数量之和不得超过7

m?string

模式(kling-v2-5-turbo、kling-v2-6模型),非必填,默认 pro,支持: pro

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"
}