新我们如何抓出挂错模型的卖家,并在发生时为你退款。

身份验证

API 密钥

推理请求使用 MartLLM API 密钥进行身份验证。密钥以 ull_ 开头,后跟随机后缀。将其作为 bearer token 传递:

Authorization: Bearer ull_your_key_here

Anthropic 接口也接受 x-api-key header 中的密钥。

您的第一个密钥会在您首次访问仪表板时为您创建,并与您可以粘贴的第一个调用一起显示。在 Dashboard → API Keys 下创建、编辑、列出和删除密钥。完整的密钥只在创建时显示一次 — 请立即存储它;MartLLM 只保留一个哈希值,并且永远无法再次显示。删除密钥(Dashboard → API keys → Delete)会立即生效:使用该密钥的应用程序将停止工作,其历史使用量仍保留在您的总计中。

按 key 的控制项

每个 key 都可以有自己的防护规则,可在创建时设置,也可以之后在 仪表盘 → API keys 中通过 编辑 设置。更改会在该 key 的下一次请求时生效。

  • 消费限额 — 在 daily、monthly 或 lifetime 窗口内以 USD 计的限额。会超出该限额的请求会被拒绝,并返回 402 key_spend_cap_exceeded。留空表示不限额。
  • 每日限额 — daily_limit_usd,在消费限额之外。一个请求必须同时满足两者,每日限额在 UTC 午夜重置。超过任一限额的请求都会被拒绝,并返回 402 key_spend_cap_exceeded,且不会扣费。可以在 Keys 页面设置,或用 PATCH /api/v1/keys/{id} 设置。
  • 速率限制 — 每分钟请求上限(1 到 10,000)。留空表示使用标准的按 key 限额(每分钟 300)。
  • 不要保存我的请求和回答 — 默认关闭:MartLLM 会保留每个请求及其回答 90 天,用于修复失败的请求和解答支持问题。开启后,使用该 key 发起的调用不会被保存。我们只保留每次调用的记录(时间、模型、token 数量、费用、来源地址、我们尝试过的提供商以及它们返回的任何错误),不保留你发送的内容或返回的内容,因此无法为你排查错误回答。视频和音乐任务仍会保留其请求,这样提供商中断的任务可以重新启动。无论是否开启,处理请求的提供商都会收到它。可以在 Keys 页面设置,或在 POST /api/v1/keys 和 PATCH /api/v1/keys/{id} 上用 no_store(true/false)设置;GET /api/v1/keys 会返回该设置。
  • BYOK 提供商 — 将该 key 固定为通过你自己的提供商凭据路由(见下文)。

低余额提醒邮件

在 Dashboard → Credits,您可以设置当您的余额低于您设定的金额时接收邮件提醒。此功能默认关闭,每次余额低于该金额时发送一封邮件,发送给账户所有者。如果为图片、视频、音乐或语音请求预留的资金在任务结束后 15 分钟仍被保留,账户所有者将收到一封列出这些任务的邮件,并且我们的团队也会收到通知。这笔资金仍然属于您,并将被释放。

BYOK — 自带密钥

在 Dashboard → BYOK 下添加提供商凭证。通过 BYOK 提供商路由的请求会直接使用您的凭证;不预留任何积分,并且在您的 MartLLM 余额中,每个 token 的成本为零。存储的凭证已加密,并且仅以遮蔽的最后-4位形式显示。

仪表盘会话

您可以登录到网页仪表盘,使用 Google 账号(一键登录:通过 martllm.com 上的“继续使用”提示,或点击 Google 按钮),或使用您的电子邮件地址:我们会发送一个 6 位数的验证码(以及一个登录链接),该验证码在 15 分钟后失效。无需密码。登录后会生成一个短期会话,该会话存储在 httpOnly cookie 中。此会话与您的 ull_ 个推理密钥是独立的—— /api/v1/* 下的仪表盘 endpoint 使用 cookie;而 gateway (/v1/*) 则使用 API key。

错误

认证失败会返回一个OpenAI风格的错误封装:

{ "error": { "code": "invalid_api_key", "message": "…", "type": "authentication_error" } }

查看 错误与限制 获取完整列表。