用途 runapi-cli 是 RunAPI 模型任务的执行层命令行工具，供智能体或脚本在终端、服务器或 CI 环境中调用 RunAPI 服务，例如生成 AI 图像、视频、音乐与音频，或运行一次性模型任务。
主要能力
- 以 JSON 方式传入请求体（--input-file、--input 或 stdin），默认同步轮询直至任务完成。
- 支持异步提交任务（--async）并配合 runapi wait <task-id> 等待完成，或用 runapi get 查询任务。
- JSON 响应输出到 stdout，进度信息输出到 stderr，便于通过 jq 等工具解析。
- 提供账户信息与余额查询（runapi account info、runapi account balance）。
- 支持将技能安装到其他智能体运行时，例如 Claude、Codex、Gemini、OpenClaw，或用 --target-dir 指定目录。
- 通过 --help 逐级查看服务、命令及其请求字段说明。
安装与鉴权 macOS/Linux 可用 brew install runapi-ai/tap/runapi；服务器或 CI 可下载安装脚本检查后本地运行，并可用 --version 指定版本（如 v0.1.0），安装器会校验 SHA-256。鉴权可读取环境变量 RUNAPI_API_KEY，或通过 stdin 导入令牌；浏览器登录 runapi login 仅在用户明确要求时使用。RUNAPI_BASE_URL 可覆盖默认基地址。
使用方式示例 runapi suno text-to-music --input-file request.json runapi suno text-to-music --async --input-file request.json runapi wait <task-id> --service suno --action text-to-music runapi get <task-id> --service suno --action text-to-music
适用场景 适合智能体生成图像、视频或音频，提交异步长任务，查看鉴权与账户状态，以及在脚本或 CI 中调用 RunAPI。
限制与安全 需要有效的 RunAPI 账户或 API 密钥；部分任务耗时长，应使用异步模式并等待；浏览器登录为交互式操作，不宜作为智能体默认路径；该工具不替代模型专属参数校验，构建请求前应查看命令帮助。避免在命令参数中直接传递密钥，优先使用环境变量或 stdin；运行安装脚本前应检查，并在声明成功前核对实际任务状态与输出。