SuperAPI AI 工具集

klingai-sdk-patterns

通用与其它

查看项目

更新于 10-15 23:26

技能介绍

用途:为 Kling AI API 提供生产可用的客户端集成模式,帮助开发者构建稳健、可维护的调用封装,而非一次性脚本。

主要能力:自动刷新 JWT(HS256,含过期缓冲);类型化请求与响应模型(KlingConfig 数据类);指数退避轮询任务状态;异步批量提交(wait=False 返回 task_id);结构化错误处理(KlingError、KlingGenerationError、KlingTimeoutError);针对 429 与 5xx 的瞬态错误重试装饰器。

使用方式:提供 Python 与 Node.js 两种客户端实现。Python 侧通过 KlingClient 调用 text_to_video、image_to_video、extend_video,默认同步等待结果,传 wait=False 则仅返回 task_id。凭据从环境变量 KLING_ACCESS_KEY、KLING_SECRET_KEY 读取,基础地址为 https://api.klingai.com/v1。轮询默认间隔 10 秒、最多 120 次(约 20 分钟),间隔按 1.2 倍递增至上限 30 秒。

适用场景:需要稳定调用 Kling AI 视频生成接口的后端服务、批处理任务与 CI 沙箱验证。

限制与前置条件:需固定 SDK 版本、沙箱工作区、密钥引用、合成或已授权素材、经批准的速率与额度限制、内容策略检查及回滚负责人。不得硬编码凭据或提交私有/未授权素材;需应用幂等、有界重试、脱敏遥测与显式任务取消。出现认证、策略、权利、范围、预算或留存漂移时应停止并恢复先前配置。具体定价、平台支持范围与效果数据暂未提供。