用途：runapi CLI 仅用于执行已安装命令目录中服务的一次性产物或结果；应用、后端、worker、库或生产代码集成应改用 RunAPI SDK。
安装：macOS/Linux 交互式用 brew install runapi-ai/tap/runapi；服务器/CI 无头环境用 curl -fsSL https://runapi.ai/cli/install.sh | sh，安装器会校验 SHA-256。
认证：先运行 runapi auth status。可用环境变量 RUNAPI_API_KEY，或 printf '%s' "$RUNAPI_API_KEY" | runapi auth import-token --token -，或交互式 runapi login。避免直接传 --token "$KEY"，以免在 ps -ef 中泄露。
发现与执行：CLI 以 JSON 为先，先用 runapi --help、runapi <service> --help、runapi <service> <action> --help 逐级确认服务、动作与字段，不要猜测。执行示例：runapi suno text-to-music --input-file request.json；异步用 --async 加 runapi wait <task-id> --service suno --action text-to-music；查询用 runapi get。JSON 输出到 stdout，进度到 stderr。
账户与定价：runapi account info、runapi account balance；runapi pricing list 与 pricing quote 可查实时估价，普通定价查询无需 API 密钥。
x402 自付费 REST：仅 REST，CLI 与 MCP 不提供 x402 传输。需钱包持有 Base 主网 USDC，使用 x402 v2 客户端签名，首次请求返回 402 与 PAYMENT-REQUIRED，重放带 PAYMENT-SIGNATURE，成功后保留 PAYMENT-RESPONSE。仅 per_call 且单价不超过 10 USDC 的端点自动符合条件。
文件与上传：可将本地路径传给顶层媒体 URL 字段，CLI 会先上传并替换为临时 URL；runapi files create 返回一小时临时 URL，持久文件用 files create-file 等命令。
限制：服务缺失时应走 SDK 或公开 API，而非猜测命令；监听器需 runapi login 凭证，普通导入密钥不可用；失败 Task 的退款为人工操作，无自动链上退款。