用途:帮助新建 OpenRouter 集成、轮换密钥或排查认证问题,完成 API 凭据配置、OpenAI 兼容客户端初始化、认证验证与额度查询。
主要能力:生成并管理 sk-or-v1- 密钥;通过环境变量或 .env 配置 OPENROUTER_API_KEY;用 OpenAI SDK 指向 https://openrouter.ai/api/v1 初始化客户端,并设置 HTTP-Referer 与 X-Title 头用于仪表盘归属;调用 /api/v1/auth/key 验证认证并查看密钥标签、已用额度、额度上限、免费层标志与速率限制;发送测试请求(如 google/gemma-2-9b-it:free)确认端到端可用;通过 Management API 创建、列出密钥并设置额度上限;处理 401/403 等认证与额度错误。
使用方式:在 openrouter.ai/keys 创建密钥并立即复制;将密钥写入 .env(加入 .gitignore)或直接 export;Python 用 OpenAI(base_url=..., api_key=..., default_headers=...) 初始化,TypeScript 用 new OpenAI({baseURL, apiKey, defaultHeaders});随后运行认证检查与测试请求。
适用场景:新项目接入 OpenRouter、密钥轮换、CI 密钥扫描、企业密钥管理与按服务发放密钥。
限制:需 OpenRouter 账户、Python 3.8+ 或 Node.js 18+ 及 OpenAI SDK;密钥仅显示一次;管理密钥不能调用补全接口;付费模型余额为零会返回 403,可改用 :free 模型。具体价格与平台细节资料未提供。