LEAPERone 文档

CLI

安装并使用 LEAPERone CLI,在终端中登录、创建 API 密钥、查询余额、查看端点并阅读文档。

LEAPERone CLI 支持无登录发现实时 API 目录,也支持通过带权限范围的控制令牌管理 API 密钥、余额和账户操作。

安装

无需安装,直接通过 npx 运行:

npx @leaperone/cli

也可以全局安装:

npm install -g @leaperone/cli

全局安装后,可以使用 leaperone 命令及其短别名 lpr

身份验证

登录并将 CLI 连接到你的 LEAPERone 账户:

npx @leaperone/cli auth login

该命令会打开浏览器完成身份验证。如果你使用无界面服务器或远程机器,请使用设备授权流程:

npx @leaperone/cli auth login --device

查看当前身份验证状态:

npx @leaperone/cli auth status

退出登录并删除已保存的凭据:

npx @leaperone/cli auth logout

命令

API 密钥

# List all API keys
npx @leaperone/cli apikey list

# Create a new API key
npx @leaperone/cli apikey create -n "my-app-key"

# Revoke an API key by name
npx @leaperone/cli apikey revoke -n "my-app-key"

新建的 API 密钥只会显示一次,请立即妥善保存。

余额

# Check your current credit balance
npx @leaperone/cli credit balance

# View recent usage history
npx @leaperone/cli credit usage

# Show last 50 records
npx @leaperone/cli credit usage -l 50

公共发现

无需登录即可浏览实时 API 目录:

# List all API endpoints
npx @leaperone/cli --json endpoints list

# Search the current model catalog
npx @leaperone/cli --json models search grok

# List and read documentation
npx @leaperone/cli --json docs list
npx @leaperone/cli docs read quickstart

# Show configured URLs and check public API catalogs
npx @leaperone/cli --json doctor

升级

如果你全局安装了 CLI,可以直接在终端中升级:

# Upgrade the global install
leaperone upgrade

# Short alias also works
lpr upgrade

如果你使用 npx,直接运行最新版本的软件包:

npx @leaperone/cli@latest

JSON 输出

所有命令都支持 --json 参数,可输出机器可读格式,适合脚本和 CI 流程:

npx @leaperone/cli credit balance --json
lpr credit balance --json
JSON 输出示例
{
  "paid": 10.0,
  "gift": 5.0,
  "total": 15.0,
  "giftExpiresAt": "2026-04-01T00:00:00.000Z"
}

Agent Skills

LEAPERone CLI 内置了 Agent Skills。这是一组可复用的指令集,能帮助 AI 编程助手(Claude Code、Cursor、Codex、Windsurf 等)理解如何使用 LEAPERone。

快速安装

# View install guide
npx @leaperone/cli skills

# Auto-discover from node_modules (recommended)
npx skills-npm

# Or install via skills CLI
npx skills add $(npx @leaperone/cli skills path)

# Or manual copy (Claude Code)
cp -r $(npx @leaperone/cli skills path)/leaperone-cli ~/.claude/skills/

功能

安装后,你的 AI agent 将能够:

  • 完成身份验证并管理 API 密钥
  • 查询余额和用量
  • 接入 OpenAI 兼容、Anthropic 兼容、媒体和数据接口
  • 实时发现文档、模型、价格和端点状态

支持的 Agent

Skills 支持 40 多种 AI 编程助手,包括 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini CLI 等。

环境变量

控制面自动化使用带权限范围的 lpc_ 令牌:

export LEAPERONE_CONTROL_TOKEN=lpc-your-control-token
npx @leaperone/cli credit balance

应用调用 /v1/* 时使用独立的 sk- 模型 API Key,通常保存为 LEAPERONE_API_KEY。CLI 仍为旧控制面流程兼容该变量,但会输出警告,新自动化不应依赖它。

使用 --json 时只解析 stdout。警告会写入 stderr。