---
title: "大模型 API 密钥是什么？如何使用和保护 | BroadRouter"
description: "API 密钥用于识别和授权对大模型 API 的调用，任何持有者都能花你的余额。Bearer 密钥如何工作，以及如何存储、限制和吊销密钥。"
url: https://broadrouter.com/zh/glossary/api-key/
lang: zh-Hans
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

本页由英文原文借助 AI 翻译。 [阅读英文原文](https://broadrouter.com/glossary/api-key/) (2026-11-14 更新).

# API 密钥（API key）

更新于 2026-11-14

API 密钥是一串用于识别和授权 API 调用方的秘密字符串。大模型 API 通常要求把它放在 Authorization: Bearer 请求头里，任何持有该密钥的人都能发起请求，费用记在拥有该密钥的账户上。

又称： API key、API 令牌、秘钥、密钥、访问令牌、Bearer token、推理密钥、API token、secret key、bearer token、inference key

API 密钥就像程序用的密码。它同时也是一种支出授权：谁拿到它，谁就能花你的余额。

## 工作原理

大模型 API 把密钥当作 Bearer 令牌。客户端在每个请求中发送它：

```bash
curl https://inference.broadnet.ai/v1/models \
  -H "Authorization: Bearer $BROADNET_API_KEY"
```

RFC 6750 对 Bearer 令牌的定义是 “any party in possession of the token”（译文：任何持有该令牌的一方）都可以使用它，没有第二重验证。所以同一份 RFC 规定，客户端必须始终通过 TLS（`https://`）发送 Bearer 令牌。

服务商会查找密钥、找到对应账户、检查限制和策略，然后处理或拒绝请求。缺少密钥或密钥错误通常返回 401；被策略拒绝的密钥（例如 [IP 白名单](https://broadrouter.com/zh/glossary/ip-allow-list/)）通常返回 403。

## 为什么重要

密钥泄露是 API 账单失控最常见的原因之一，因为有机器人专门扫描公开代码中的密钥。如果密钥能访问返回账户信息的端点，还可能泄露数据。按照 OWASP 的密钥管理指南，良好的做法是：

-   从环境变量或密钥管理服务中加载密钥。绝不要提交到代码仓库，也不要打包进容器镜像。
-   给每个应用或智能体单独的密钥，这样吊销一个时不会影响全部。
-   定期轮换密钥，一旦怀疑泄露就立即轮换。
-   限制密钥的使用范围，例如设置服务器 IP 白名单。

## 在 BroadNet Inference 上

BroadNet 区分两种凭据。**推理密钥**用于在 `/v1/*` 上调用模型。**门户凭据**用于自动化管理账户：密钥、允许的 IP 和购买操作。请把后者视为拥有完整账户权限。

两者都只显示一次。BroadNet 只保存 SHA-256 哈希值，因此无法再次显示密钥。按量付费密钥有效期一年，一个账户最多可持有十个有效密钥。每个密钥可以有自己的 IP 白名单。吊销密钥或修改白名单后，新请求会在五秒内被停止。

[固定价格套餐](https://broadrouter.com/zh/glossary/flat-rate-llm-plan/)的套餐密钥是独立的，从不扣减你的余额。设置步骤见 [API 密钥与 IP 白名单](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/)，状态码见[错误与重试](https://broadrouter.com/zh/guides/errors-and-retries/)。

## 常见错误

-   记录完整的请求头。这会把密钥写进日志。
-   整个团队共用一个密钥。这样就无法单独吊销某个人的访问权限。
-   把密钥发给技术支持。应该发送 `X-Request-ID` 响应头的值。

## 常见问题

### 可以把大模型 API 密钥放进浏览器或手机 App 里吗？

不可以。凡是发到客户端的东西都能被提取出来。把密钥留在服务器上，让你的 App 调用你的服务器，再由服务器调用大模型 API。

### 密钥泄露了怎么办？

立即吊销，创建一个新密钥，并检查密钥暴露期间的用量。然后找出泄露途径，例如某次提交、某行日志或某张截图。

### 在 BroadNet Inference 上可以有多少个密钥？

每个账户最多十个有效的按量付费密钥。每个密钥自创建起有效一年。套餐密钥另行计算。

## 另请参阅

-   [IP 白名单（IP allow list）](https://broadrouter.com/zh/glossary/ip-allow-list/) (术语)
-   [Base URL（base\_url）](https://broadrouter.com/zh/glossary/base-url/) (术语)
-   [OpenAI 兼容 API（OpenAI-compatible API）](https://broadrouter.com/zh/glossary/openai-compatible-api/) (术语)
-   [速率限制（rate limit）](https://broadrouter.com/zh/glossary/rate-limit/) (术语)
-   [用 IP 白名单把 API 密钥锁定到你的服务器](https://broadrouter.com/zh/guides/api-keys-ip-allow-lists/) (指南)
-   [用 OpenAI Python SDK 调用 BroadNet Inference](https://broadrouter.com/zh/guides/openai-python-sdk/) (指南)
-   [BroadNet Inference 错误码，以及什么时候该重试](https://broadrouter.com/zh/guides/errors-and-retries/) (指南)
-   [零数据保留大模型 API：10 个问题的核对清单](https://broadrouter.com/zh/blog/zero-data-retention-llm-api-checklist/) (文章)

用你的真实业务负载试一试。 新账户可获得 US$5 初始额度，用于 Gemma和转写。DeepSeek、GLM和Qwen3.8 需要先充值。

[开始使用](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-api-key&utm_content=page-cta) ·

**来源**

-   [RFC 6750：OAuth 2.0 授权框架之 Bearer 令牌用法](https://www.rfc-editor.org/rfc/rfc6750)
-   [OWASP 密钥管理速查表（Secrets Management Cheat Sheet）](https://cheatsheetseries.owasp.org/cheatsheets/Secrets_Management_Cheat_Sheet.html)
-   [BroadNet Inference API 参考：密钥与 IP 白名单 （英文）](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=zh-glossary-api-key&utm_content=sources)
