跳转到主要内容
POST
  1. 提交后会返回 task_id。如果提供了 callback_url,当任务状态变为 finished 或 failed 时,系统会向 callback_url 发送 POST 请求。
  2. 无论是否提供 callback_url,都可以通过统一的查询任务状态接口获取结果。
公开 model ID:kwaivgi/kling-video/v1.6/pro/image-to-video。

输入模式

二选一:提供 start_image_url 进行首帧动画,或提供 image_urls 使用 Elements。该接口不接受纯文本请求。
  • Elements 接受 1–4 张参考图,不能与 start_image_url、end_image_url 或 cfg_scale 组合使用。
  • 提供 start_image_url 时,Pro 支持可选的 end_image_url;两种工作流程都支持宽高比。
图像字段决定所用的工作流程。

参数

生成参数放在 input 中。model 和可选的 callback_url 保留在请求根级。不支持的 input 字段会在扣除积分前被拒绝。 图像 URL 必须是带主机名的公开 HTTP(S) URL,不含内嵌凭据或空白字符。本地文件可以先在 Playground 中上传,再提交其 URL。可选参数没有文档化的 API 默认值。

计费因素

计费取决于所选模型档位(Standard 或 Pro)和视频时长(duration),按生成的秒数计费。同一档位内,文生视频、首帧动画和 Elements 费率相同。 提交时扣除积分,任务失败时退还。

授权

Authorization
string
header
必填

使用 VIDGO_API_KEY。

请求体

application/json

model 和 callback_url 放在根级。未知的根级字段会被忽略;不支持的 input 字段会被拒绝。

model
string
必填
示例:

"kwaivgi/kling-video/v1.6/pro/image-to-video"

input
object
必填

生成参数。

选择使用 start_image_url 的首帧工作流程,或使用 image_urls 的 Elements 工作流程。不要将 image_urls 与首帧控制参数组合使用。

callback_url
string | null

可选的公开 HTTP(S) 接口,用于接收任务完成通知。建议使用 HTTPS。省略、传 null 或空字符串即可禁用回调。

响应

任务已提交

code
enum<integer>
必填
可用选项:
200
data
object
必填