用途:在运行中的 LiteLLM 代理上创建新的 API 密钥(虚拟密钥),适合需要为应用、团队或用户分配受限调用凭证的场景。
主要能力:支持设置密钥别名,指定归属的 team_id 或 user_id,限制可访问的模型,设置最大预算与有效期(如 7d、30d、90d,省略则不过期),并在创建后校验密钥信息。
使用方式:先准备 LITELLM_BASE_URL(如 https://my-proxy.example.com)与 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>" 校验,输出 key(仅显示一次,需提醒用户保存)、key_alias、expires、max_budget、models。
错误处理:401 表示管理员密钥无效;400 表示缺少必填字段或 team_id/user_id 不存在;其它错误应展示详情与可能的修复方式。
限制:依赖可访问的 LiteLLM 代理与有效管理员密钥;具体可用模型、预算上限与有效期格式由部署配置决定,资料未提供更细的默认值与平台兼容性说明。