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

输入路由

提供的图像字段决定生成工作流程。 所有 Kling 1.6 请求都需要 prompt 和 duration。
  • 不提供任何图像字段时生成文生视频。
  • 提供 start_image_url 时生成图生视频。
  • 使用 kling-1.6/pro 并提供 start_image_url 和 end_image_url,可同时控制首帧和尾帧。
  • 提供包含 1 到 4 张参考图的 image_urls 时生成 Elements。
image_urls 不能与 start_image_url、end_image_url 或 cfg_scale 同时使用。

参数兼容性

注意事项:
  • end_image_url 需要同时提供 start_image_url,且仅 kling-1.6/pro 支持。
  • kling-1.6/standard 图生视频不支持 aspect_ratio。
  • Elements 支持 1 到 4 个 image_urls,不支持 cfg_scale。
  • prompt 和 negative_prompt 最多 2500 个字符。
  • 提供 cfg_scale 时,取值必须在 0 到 1 之间。

响应与状态

提交接口返回 Vidgo 的 task_id。使用它调用统一的查询任务状态接口获取最终视频 URL。 首次提交的响应包含 status,上游视频任务创建后通常为 running。如果在创建上游任务时提交失败,状态可能为 failed,可通过状态接口查看该任务。

工作流程 ID

现有 ID 仍可继续使用。新接入可以选择专用的工作流程:

授权

Authorization
string
header
必填

所有 API 接口都需要 Bearer Token 认证。在请求头中添加 Authorization: Bearer VIDGO_API_KEY。

请求体

application/json
model
string
必填
示例:

"kling-1.6/standard"

input
object
必填

生成参数。Vidgo 会根据提供的图像字段选择工作流程。

callback_url
string<uri>

接收结果通知的 Webhook 回调 URL

示例:

"https://your-domain.com/callback"

响应

200 - application/json

任务提交成功

code
integer
必填

HTTP 状态码

示例:

200

data
object
必填