视频生成通常耗时较长,接口采用“提交任务 + 查询状态”的方式。

提交视频生成任务

标准端点: POST /v1/videos 身份认证: Authorization: Bearer 您的API_KEY
提交任务后,接口不会立刻返回视频,而是会返回一个 任务 ID (task_id)

核心参数说明表

参数名称是否必填参数说明
model必填视频模型 ID,例如 kling-v2-6。请以模型广场当前列表为准。
prompt必填文字描述提示词,越详细生成的画面越贴合想象。
input_reference选填参考图片文件,图生视频时使用。
seconds选填视频时长,支持范围由所选模型决定。
size选填视频尺寸,支持范围由所选模型决定。

查询视频任务状态

获取到任务 ID (task_id) 后,您需要在业务系统中定期(例如每隔 5-10 秒)通过 GET 请求查询该任务的处理状态。
查询端点: GET /v1/videos/{task_id} 身份认证: Authorization: Bearer 您的API_KEY

状态说明

  1. queued:任务已受理,正在排队等待集群算力分配。
  2. in_progress:AI 正在渲染生成视频。
  3. completed:生成完成。根据响应中的结果字段获取视频,或调用 GET /v1/videos/{task_id}/content 下载内容。
  4. failed:生成失败。接口会一并返回失败原因(常见原因为提示词触发了内容风控审查)。

下载或重混视频

  • 下载已完成视频:GET /v1/videos/{task_id}/content
  • 基于已有视频生成新版本:POST /v1/videos/{video_id}/remix
重混只适用于支持该能力的原任务和线路。