用途:为 Kling AI API 提供错误排查参考,帮助定位视频生成失败和接口异常。
主要能力:按 HTTP 状态码列出错误、原因与解决办法,包括 400 参数或 JSON 格式错误、401 JWT 无效或过期、402 额度不足、403 内容策略违规或 API 未启用、404 task_id 或端点错误、429 超限、500/502/503 平台或上游故障。还覆盖 HTTP 200 但 task_status 为 failed 的任务级失败,如内容策略违规、图片质量过低(建议不小于 300x300px)、提示词过于复杂、生成超时、图片格式不支持(使用 JPG、PNG 或 WebP)、遮罩尺寸不匹配。
使用方式:JWT 生成时需显式传入 headers,例如 jwt.encode(payload, sk, algorithm="HS256", headers={"alg": "HS256", "typ": "JWT"});令牌不要只在导入时生成一次,应在过期前刷新(示例中保留 5 分钟缓冲)。对 429 与 5xx 使用指数退避重试,读取 Retry-After;可用 logging 记录请求与响应做调试。排查顺序为:认证是否有效、额度是否充足、model_name 是否匹配、参数是否合法(duration 为字符串 "5" 或 "10")、提示词是否干净(少于 2500 字符)、图生视频的图片 URL 是否公开可访问、image_tail、dynamic_masks 与 camera_control 是否互斥。
适用场景:开发者在 CI 沙箱等受控环境中复现和分类错误,记录聚合状态、错误类别、额度使用与任务状态,产出脱敏的排查回执。
限制:要求沙箱工作区、合成或已授权的诊断材料、密钥引用、已批准范围、脱敏规则、仅草稿目标与事件负责人;不得记录授权头、提示词、源素材、响应体或生成资源 URL。出现敏感信息、策略、权利、预算或留存偏移时应停止采集、删除产物并撤销访问。资料未提供具体价格、配额数值和平台支持范围等信息。