用途:跟踪与监控 Kling AI 视频生成任务状态,适用于构建监控看板、跟踪批量生成任务以及排查卡住的任务。覆盖 /v1/videos/text2video、/v1/videos/image2video、/v1/videos/video-extend 接口的轮询策略、批量跟踪、超时处理与基于回调的监控。
主要能力:每次生成返回 task_id,任务状态包括 submitted(排队,约0-30秒)、processing(生成中,标准30-120秒,专业60-300秒)、succeed(完成,可获取视频URL)和 failed(失败),后两者为终态。提供单任务轮询(自适应间隔、超时控制)、批量任务追踪器、卡住任务检测(超过阈值告警)以及批量监控循环示例。
使用方式:需从环境变量读取 KLING_ACCESS_KEY 与 KLING_SECRET_KEY,生成 JWT 请求头后轮询任务查询接口。使用前需具备已批准的任务队列、合成或已获授权的素材、授权工作区与积分上限、仅草稿目标、政策审查及取消/移除负责人。
限制:仅监控已批准的沙箱或生产金丝雀任务;只存储任务引用和聚合状态计数,不保存提示词、素材URL或身份信息;下游发布前须核验任务归属、政策/版权状态、积分消耗、保留策略和仅草稿路由;发现卡住、费用异常、政策/版权/范围/保留偏差时暂停并取消任务、清理临时草稿;保留已脱敏的监控凭证,并有指定负责人可恢复原队列配置。输出为监控凭证,含环境、聚合状态、队列上限、积分使用、检查项、取消结果、负责人、保留/移除证明和回滚引用,不包含提示词、素材与凭证。