提交视频生成任务
标准端点:提交任务后,接口不会立刻返回视频,而是会返回一个 任务 ID (task_id)。POST /v1/videos身份认证:Authorization: Bearer 您的API_KEY
核心参数说明表
| 参数名称 | 是否必填 | 参数说明 |
|---|---|---|
| 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
状态说明
- queued:任务已受理,正在排队等待集群算力分配。
- in_progress:AI 正在渲染生成视频。
- completed:生成完成。根据响应中的结果字段获取视频,或调用
GET /v1/videos/{task_id}/content下载内容。 - failed:生成失败。接口会一并返回失败原因(常见原因为提示词触发了内容风控审查)。
下载或重混视频
- 下载已完成视频:
GET /v1/videos/{task_id}/content - 基于已有视频生成新版本:
POST /v1/videos/{video_id}/remix