用途:帮助开发者将 Kling AI 文本转视频等异步生成能力集成进更大型系统,围绕“提交任务—回调/轮询—后续处理”的核心流程,使用队列、状态机与事件驱动架构管理任务生命周期。
主要能力:提供提交异步任务(含 callback_url 回调)与轮询完成的 Python 示例;Redis 队列工作流(生产者入队、工作进程按并发上限提交并轮询任务状态,按 completed/failed 分流);基于枚举与数据类的状态机模式(QUEUED、SUBMITTING、PROCESSING、DOWNLOADING、COMPLETED、FAILED、RETRYING,含合法状态迁移校验与重试上限);多步流水线(生成→延长→下载→上传);基于 callback_url 的 Webhook 事件驱动方式,避免轮询。
必要用法:获取 Kling 访问密钥与密钥,用 JWT(HS256,带 iss/exp/nbf)生成请求头,向 https://api.klingai.com/v1 提交任务;前置条件包括已获批的异步工作流、沙箱回调端点、合成或已授权素材、密钥引用、内容策略控制、额度预算以及取消/移除责任人。操作上要求先提交仅草稿态的沙箱任务,使用已加签、白名单回调与幂等键,回调日志中不得包含提示词或素材数据;校验任务状态迁移、回调签名、策略/权利结果、额度使用与目标后再放行下游动作;出现重复、未授权、策略、预算或留存漂移时暂停队列、取消排队任务并移除临时草稿;仅在责任人批准后推广,并保留已脱敏的聚合回执。
限制:资料未提供正式官方文档链接以外的资源、价格、平台支持范围或具体 API 速率等信息,暂未提供;错误处理需拒绝并隔离签名或幂等校验失败的回调,出现策略、权利、预算或留存漂移时取消任务、移除草稿并恢复上一版工作流配置。