身份验证
API 密钥
推理请求使用 UberLLM API 密钥进行身份验证。密钥以 ull_ 开头，后跟随机后缀。将其作为 bearer token 传递：
Authorization: Bearer ull_your_key_here
Anthropic 接口也接受 x-api-key header 中的密钥。
您的第一个密钥会在您首次访问仪表板时为您创建，并与您可以粘贴的第一个调用一起显示。在 Dashboard → API Keys 下创建、编辑、列出和删除密钥。完整的密钥只在创建时显示一次 — 请立即存储它；UberLLM 只保留一个哈希值，并且永远无法再次显示。删除密钥（Dashboard → API keys → Delete）会立即生效：使用该密钥的应用程序将停止工作，其历史使用量仍保留在您的总计中。
密钥级控制
每个密钥都可以有自己的安全限制，可以在创建时设置，也可以之后通过 控制面板 → API 密钥 页面上的 编辑 进行设置。更改将在密钥的下一次请求中生效。
- 消费限额 — 在
daily、monthly或lifetime时间窗口内设置的美元上限。超出此限额的请求将被拒绝，并返回402 key_spend_cap_exceeded。留空表示没有限制。 - 每日限额 —
daily_limit_usd，在消费限额之上。请求必须同时符合这两个限制，每日限额在 UTC 午夜重置。任何超出任一限额的请求都将被拒绝，并返回402 key_spend_cap_exceeded，且不收取任何费用。可以在密钥页面或使用PATCH /api/v1/keys/{id}进行设置。 - 速率限制 — 每分钟请求上限 (1 到 10,000)。留空表示使用标准的每个密钥限制 (每分钟 300)。
- BYOK 提供商 — 将密钥绑定，通过您自己的提供商凭据进行路由 (见下文)。
低余额提醒邮件
在 Dashboard → Credits，您可以设置当您的余额低于您设定的金额时接收邮件提醒。此功能默认关闭，每次余额低于该金额时发送一封邮件，发送给账户所有者。如果为图片、视频、音乐或语音请求预留的资金在任务结束后 15 分钟仍被保留，账户所有者将收到一封列出这些任务的邮件，并且我们的团队也会收到通知。这笔资金仍然属于您，并将被释放。
BYOK — 自带密钥
在 Dashboard → BYOK 下添加提供商凭证。通过 BYOK 提供商路由的请求会直接使用您的凭证；不预留任何积分，并且在您的 UberLLM 余额中，每个 token 的成本为零。存储的凭证已加密，并且仅以遮蔽的最后-4位形式显示。
仪表盘会话
您可以登录到网页仪表盘，使用 Google 账号（一键登录：通过 uberllm.dev 上的“继续使用”提示，或点击 Google 按钮），或使用您的电子邮件地址：我们会发送一个 6 位数的验证码（以及一个登录链接），该验证码在 15 分钟后失效。无需密码。登录后会生成一个短期会话，该会话存储在 httpOnly cookie 中。此会话与您的 ull_ 个推理密钥是独立的—— /api/v1/* 下的仪表盘 endpoint 使用 cookie；而 gateway (/v1/*) 则使用 API key。
错误
认证失败会返回一个OpenAI风格的错误封装：
{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }
查看 错误与限制 获取完整列表。