klingai-known-pitfalls

用途：汇总真实 Kling AI 集成中出现的错误、坑点与反模式，每条包含症状、根因和已验证的修正方案，适合排错或学习最佳实践。主要能力：指出多种常见问题并可搭配修复——duration 必须是字符串"5"或"10"而非整数，否则返回 400；JWT 需显式带头 headers={"alg":"HS256","typ":"JWT"}，否则即使 AK/SK 正确也返回 401；Token 约 30 分钟过期，须每请求生成或自动刷新（建议留 5 分钟缓冲）；轮询要设超时（如 600 秒）并检查 failed 状态，避免死循环；Kling CDN 视频 URL 仅 24–72 小时有效，生成后应立即下载并转存自有存储；图生视频时 camera_control、dynamic_masks/static_mask、image_tail 互斥，每次只能用一组；kling-v1-5 与 kling-v2-1 仅支持图生视频，文生视频需选用 kling-v2-master、kling-v2-5-turbo 等支持 T2V 的模型；须处理 task_status 的 failed 终态，避免静默失败；原生音频（v2.6，motion_has_audio: true）会使积分成本乘 5（如 5 秒标准无音频 10 积分、含音频 50 积分）；提示词应具体，包含主体、动作、光线、机位与风格。使用方式：按资料中的前置条件准备已批准的沙箱 brief、权利清晰或合成素材、密钥引用、内容策略审查、积分上限、仅草稿目的地和清理负责人；用单个带水印沙箱草稿复现问题，勿用私有或未授权材料；应用变通前核查鉴权、模型/模式、时长、政策权利、积分、目的地与保留；若变通改变归属、署名或政策姿态则拒绝并删除临时草稿；重复任务或预算失败时取消排队任务并恢复已批准配置；产出脱敏的问题回执（环境、失败分类、素材分类、修正设置、汇总结果、政策/权利/预算检查、仅草稿状态、清理证明与回滚引用），不含提示词、素材、身份与凭据。限制：资料为坑点清单，不提供完整官方文档；价格、积分与有效期以资料所述为准，其他平台或收费细节暂未提供。