add-key について
稼働中の LiteLLM プロキシに API キーを作成するスキルです。任意でエイリアス、対象範囲、モデル、予算、有効期限を設定し、作成結果を確認します。
主な機能
- 01LiteLLM プロキシ API キーの生成
- 02エイリアスとチームまたはユーザー範囲の設定
- 03利用可能なモデルの制限
- 04予算と有効期限の設定
- 05キー情報の確認と報告
活用シーン
- 01アプリケーション用のキー作成
- 02キーをチームまたはユーザーに限定
- 03キーの利用モデルや支出を制限
- 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
ユーザーへの確認事項
- キーのエイリアス(任意ですが、設定を推奨します。例:
my-app-prod) - スコープ —
team_idまたはuser_idに割り当てますか?(任意) - 許可するモデル(任意。例:
gpt-4o, claude-3-5-sonnet) - 最大予算(任意。例:
5.00) - 有効期限(任意。例:
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 対応