Kuaishou Kling AI

先分清平台与本站

Kling AI 是快手的图像与视频生成平台。直连 Kling 与通过本站调用是两套认证：直连遵循 Kling 的 JWT 规则；本站 /v1/videos 使用本站令牌，只代表本站已经适配的统一视频任务入口。网页端出现的功能不等于 API 或本站都已开放，精确模型与入口请先查模型广场。

直连认证不是把 AK 或 SK 填进 Bearer

先在 Kling 控制台取得 Access Key（AK）和 Secret Key（SK），再按 RFC 7519 用 AK/SK 签发有短有效期的 JWT，最后发送 Authorization: Bearer <JWT>。SK 只能保存在服务端秘密管理器；不要提交到仓库、浏览器或日志，也不要长期复用即将过期的 token。本站令牌不能拿去直连 Kling，Kling 的 AK/SK 也不能直接用于本站。

创建任务后保存两个不同 ID

创建接口返回的 request_id 用于定位一次 HTTP 请求和联系支持排障；task_id 才是生成任务标识，用来查询进度与结果。保存两者、创建时间、模型和脱敏参数，避免把 request_id 拼进任务查询路径。任务状态依次落在 submitted、processing、succeed 或 failed：前两者是处理中，后两者是终态。

轮询要有边界

客户端应按任务查询接口轮询 task_id，使用带随机抖动的有限指数退避，并设置最大次数、总超时和取消机制。仅在 succeed 后读取结果；failed 应记录错误与 request_id，参数或审核错误不能靠无限重试修复。结果媒体应尽快复制到自己的受控存储，不要把厂商返回 URL 当作永久资产地址。

成本、限流与安全

提交前校验素材类型、大小、画幅、时长和模型支持范围；对同一业务请求使用幂等记录，防止超时重试重复创建并计费。对 401/403 检查 JWT 与权限，对 429 降低提交和查询频率，对临时 5xx 才做有限重试。上传真人、人脸、商标或受版权保护素材前，应取得授权并处理内容审核、隐私和商业使用要求。