mcpField
A
add-key

add-key

github.com/berriai云与 DevOps103140 次安装25 周前更新
代码仓库

关于 add-key

这项技能用于在运行中的 LiteLLM 代理上创建 API 密钥。它可收集别名、范围、模型、预算和有效期等可选设置，并验证创建结果。

主要功能

  1. 01生成 LiteLLM 代理 API 密钥
  2. 02设置别名及团队或用户范围
  3. 03限制允许使用的模型
  4. 04配置预算和有效期
  5. 05验证并报告密钥详情

适用场景

  1. 01为应用创建密钥
  2. 02将密钥限定到团队或用户
  3. 03限制密钥可用模型或支出
  4. 04检查新生成的密钥

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/berriai/litellm-skills --skill add-key

安装后在 Claude Code 中输入/add-key确认已加载。

详细介绍

添加密钥

在运行中的 LiteLLM 代理上生成新的 API 密钥。

设置

如果尚不清楚，请询问以下信息：

LITELLM_BASE_URL  — e.g. https://my-proxy.example.com
LITELLM_API_KEY   — proxy admin key

API 参考：https://litellm.vercel.app/docs/proxy/virtual_keys

询问用户

  1. 密钥别名（可选，但建议填写，例如 my-app-prod）
  2. 范围 — 分配给 team_id 还是 user_id？（可选）
  3. 允许使用的模型（可选，例如 gpt-4o, claude-3-5-sonnet）
  4. 最高预算（可选，例如 5.00）
  5. 有效期（可选，例如 7d、30d、90d）——不填写则表示永久有效

执行

BASE="$LITELLM_BASE_URL"
KEY="$LITELLM_API_KEY"

curl -s -X POST "$BASE/key/generate" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "key_alias": "<alias>",
    "team_id": "<team_id_or_omit>",
    "user_id": "<user_id_or_omit>",
    "models": [<models_or_empty>],
    "max_budget": <budget_or_null>,
    "duration": "<duration_or_omit>"
  }'

验证

确认密钥已创建：

curl -s "$BASE/key/info" \
  -H "Authorization: Bearer <new_key>" | python3 -c "
import sys, json
d = json.load(sys.stdin)
info = d.get('info', {})
print(f'Alias: {info.get(\"key_alias\")}')
print(f'Expires: {info.get(\"expires\")}')
print(f'Budget: {info.get(\"max_budget\")}')
print(f'Models: {info.get(\"models\")}')
"

输出

向用户显示：

  • key — 实际密钥值（仅显示一次，请提醒用户保存）
  • key_alias、expires、max_budget、models

发生错误时：

  • 401 — 检查 LITELLM_API_KEY 是否为有效的管理员密钥
  • 400 — 检查必填字段；确认 team_id/user_id 是否存在
  • 其他错误 — 显示 detail 和可能的解决方法

评论

支持 Markdown