跳转到主要内容
POST
Kling 4.0 在 AIReiter 中的模型名称为 kling_v4。用 type 选择生成模式,不同模式接收的素材不同,见下方 模式参数对照。成片始终带立体声音轨,不能关闭。不支持 4K、negative_prompt、seed。

Authorizations

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

Body

string
必填
模型名称,固定为 kling_v4。
object
必填
模型参数对象。
string
必填
发起方任务 ID。用户自定义的任务标识,必填。仅支持字母、数字、下划线和横线,长度为 1-64 个字符。后续可使用该 ID 查询任务状态和结果。

Response

string
发起方任务 ID,可用于查询结果。
string
初始状态,通常为 "pending"。
string
创建时间,ISO 格式。

Query Task

Kling 4.0 是异步视频生成模型。提交任务后,请使用 out_task_id 查询任务状态。也可参见 获取任务状态。
string
必填
提交任务时传入的发起方任务 ID。
查询成功并完成后,响应中的 output 数组会包含生成的视频,元素含 video 字段。 生成耗时因模式和时长而异:1080p 5 秒文生视频实测约 4.5 分钟,时长越长、素材越多耗时越久,请持续轮询,不要重复提交。

模式参数对照

frame 模式缺少首帧、edit / extend 模式缺少原视频时,任务会以失败结束。请按上表传齐必需素材。

使用说明

  • 只传提示词时就是文生视频;传了任意参考素材后按参考生成处理,aspect_ratio 为 auto 时跟随素材比例。
  • 视频续写返回一个完整文件:原视频在前,新增片段在后。实测 5 秒原视频续写 5 秒,返回 10.0 秒的视频,分辨率与原视频一致,衔接处无明显接缝。
  • 视频续写会保留原视频部分的声音,新增片段自动生成声音;原视频没有声音时,这部分仍然无声。
  • 视频编辑默认保留原视频声音,需要新的声音时传 audio_setting: "auto"。

Request Examples