用途:帮助初学者跑通 Kling AI 文生视频接口,完成“创建任务—轮询状态—获取视频链接”的完整循环。接口基础地址为 https://api.klingai.com/v1,先决条件:已完成 klingai-install-auth 鉴权配置、Python 3.8+ 并安装 requests 与 PyJWT、账户至少 10 积分。
主要能力:提供 Python 与 Node.js 两种最小示例。Python 端使用 KLING_ACCESS_KEY、KLING_SECRET_KEY 环境变量,通过 HS256 生成 JWT 后调用 POST /videos/text2video 创建任务,参数如 model_name、prompt、duration、aspect_ratio、mode;随后轮询 GET /videos/text2video/{task_id},状态为 succeed 时从 task_result.videos[0].url 取视频地址,failed 时读取 task_status_msg。Node.js 端用 jsonwebtoken 签发 token,逻辑一致。
状态与成本:任务状态有 submitted、processing、succeed、failed。5 秒 standard 视频消耗 10 积分;免费额度每日 66 积分,每日刷新不累积。standard 模式约需 60–120 秒。
常见问题:401 多为 JWT 过期或 AK/SK 有误;task_status 失败通常是提示词过于笼统;videos 为空说明仍在处理,需继续轮询。
操作与限制:建议在沙箱中运行首次请求,使用合成或已获授权的素材简报并设置积分上限,不要把凭据写入代码或日志;首次只请求带水印的草稿样片,核对任务状态、政策与权利状态;若质量、政策、署名或预算检查不通过,应取消任务并删除草稿,不要用冒烟测试结果对外发布。仅记录脱敏回执,并在保留期限到达时删除临时素材。输出回执应包含环境、简报分类、模型与模式、时长、积分估算、任务状态、政策权利检查、仅为草稿声明、负责人与清理引用,排除提示词、素材 URL、身份信息和密钥。SKILL 触发词暂未完整提供。