Skip to main content
POST

认证

string
必填
所有接口均需要使用 Bearer Token 进行认证获取 API Key:访问 API Key 管理页面 获取您的 API Key使用时在请求头中添加:

请求参数

string
必填
视频生成模型名称支持的模型:
  • kling-video-o1 - 可灵 Video O1(推理增强,最高质量)
string
必填
正向文本提示词支持通过 <<<image_N>>> 语法引用 image_urls 中的图片,N 从 1 开始。示例:"让<<<image_1>>>中的人物向镜头挥手"
如果传了图片但 prompt 中没有 <<<image_N>>> 引用,系统会自动在 prompt 前添加 <<<image_1>>>
string
默认值:"std"
生成模式可选值:
  • std - 标准模式(720P)
  • pro - 专业模式(1080P)
默认值:std
integer
默认值:"5"
视频时长(秒)可选值:510默认值:5
string
默认值:"16:9"
视频宽高比可选值:
  • 16:9 - 横屏
  • 9:16 - 竖屏
  • 1:1 - 方形
默认值:16:9
array<url>
图片 URL 数组,用于图片引用在 prompt 中通过 <<<image_N>>> 引用对应位置的图片(N 从 1 开始)示例:["https://example.png"]
  • 图片 URL 必须公开可访问,不能有防盗链
  • 图生视频时,aspect_ratio 可能被图片实际比例覆盖
  • 最多两张图片,且数组中第一张为首帧,第二张为尾帧
array<object>
带角色图片数组,推荐用于图生视频。每项结构:{ "url": "...", "role": "..." }
  • first_frame:首帧
  • last_frame:尾帧
  • reference:参考图
  • image_urlsimage_with_roles 二选一,不要同时传,
  • 超过2张图片时,不支持设置首尾帧。
array
参考视频列表(URL 方式),最多 1 段。通过 refer_type 区分类型:
  • base:待编辑视频(默认)
  • feature:特征参考视频
通过 keep_original_sound 控制是否保留原声:
  • no:不保留(默认)
  • yes:保留原声
请求体格式:
  • video_url 不能为空,且视频 URL 需可访问
  • refer_type=base 时:
    • 不能定义视频首尾帧
    • 参考视频需 3–10 秒
    • 生成视频时长以上传视频为准
  • refer_type=featurevideo_url 不为空时:
    • image_urls 只可上传首帧图片
  • 视频要求:仅支持 MP4/MOV;时长不少于 3 秒;分辨率 720px-2160px;帧率 24-60fps(输出为 24fps);大小不超过 200MB

图片引用语法

Video O1 模型使用 <<<image_N>>> 语法在提示词中引用图片,实现统一的文生视频/图生视频体验:
自动引用:如果传了 image_urls 但 prompt 中没有 <<<image_N>>> 引用,系统会自动在 prompt 前添加 <<<image_1>>>

响应

integer
响应状态码,成功时为 200
array
返回数据数组

使用场景

场景 1:文生视频(最高质量)

场景 2:图片引用(单张图片)

场景 3:多图片引用

场景 4:传图片但不显式引用(自动添加)

系统会自动在 prompt 前添加 <<<image_1>>>,等效于 "<<<image_1>>>人物缓缓转头微笑"
查询任务结果视频生成为异步任务,提交后会返回 task_id。使用 获取任务状态 接口查询生成进度和结果。