用途：kie-pp-cli 是 Kie.ai AI 生成平台的统一命令行接口，覆盖图像、视频、音乐、聊天模型，以及账户余额与文件上传等工具。异步生成接口返回 taskId，需轮询对应的 record-info/get-details 接口（或使用 callBackUrl）获取结果。
安装与验证：先安装 CLI，macOS/Linux 默认安装到 $HOME/.local/bin，Windows 为 %LOCALAPPDATA%\Programs\PrintingPress\bin，命令为 npx -y @mvanhorn/printing-press-library install kie --cli-only，随后用 kie-pp-cli --version 验证；需确保安装目录在 $PATH 中。若 --version 报 command not found，则运行时看不到该二进制目录，在验证成功前不要执行技能命令。
主要能力：包含 aleph、chat、claude、codex、common、file-base64-upload、file-stream-upload、file-url-upload、flux、gemini 系列、generate（音乐生成、加伴奏/人声、扩展、混搭、音效、角色等）、gpt-5-2、gpt4o-image、grok、kie-ai-jobs、lyrics、midi、mp4、omni、responses、runway、style、suno、veo、vocal-removal、voice、wav 等命令族。
用法要点：可用 kie-pp-cli which "<自然语言能力描述>" 将查询解析为最佳匹配命令，退出码 0 表示有匹配，2 表示无可靠匹配。认证方面，运行 kie-pp-cli auth setup 获取令牌后执行 kie-pp-cli auth set-token YOUR_TOKEN_HERE，或设置 KIE_BEARER_AUTH 环境变量；用 kie-pp-cli doctor 验证配置。任意命令可加 --agent（展开为 --json --compact --no-input --no-color --yes），支持 --select 字段筛选、--dry-run 预览、--idempotent 显式重试；读取本地存储或 API 的命令输出带 meta/results 信封，解析 .results 取数据、.meta.source 判断 live 或 local。路径可通过 --home 或 KIE_HOME 及分类型环境变量重定位；凭证存于 data 目录下的 credentials.toml。
适用场景与限制：适合以脚本或智能体方式批量调用 Kie.ai 的图像、视频、音乐与聊天生成能力，并借助 recall/learnings 机制复用查询经验。上传文件为临时文件，24 小时后自动删除；gpt4o-image 生成图像存储 14 天后过期。收费、价格与具体平台支持范围暂未提供。