“Llama API Key”是搜索量很高的词,但它对应的并不是一个统一产品。2026 年 7 月 6 日,Meta 的 Llama API 公共预览版正式下线;今天要继续使用 Llama,通常要走云厂商、推理平台、自建部署或 OpenAI 兼容网关。每条路线拿到的凭证不同:有的是 Bearer Token,有的是云账号的临时签名凭证,有的根本不需要 Key。
本文按路线讲清 Key 从哪里来、权限怎么收、环境变量怎么放、401 怎么排查、泄露后怎么轮换。模型与计费口径以站内模型价格为准。
说明:Meta、Llama 是 Meta Platforms, Inc. 的商标;文中其他平台与模型名称分别为其权利人的商标。本文仅作技术说明,与 Meta 及相关平台不存在隶属、代理或背书关系。
一、先分清:四种“Llama API Key”
| 路线 | 凭证形态 | 在哪里创建 | 适合谁 |
|---|---|---|---|
| 云厂商托管 | IAM 角色、临时凭证或资源 Key | AWS IAM、Microsoft Foundry、Google Cloud 控制台 | 已有云合同、需要审计与区域合规 |
| 推理平台 | Bearer API Key | Groq、OpenRouter 等平台控制台 | 想快速接入、不想运维 GPU |
| 自建推理 | 自建鉴权或内网免鉴权 | vLLM、Ollama、llama.cpp | 数据边界要求高、有 GPU |
| 兼容网关 | 网关 API Key | 网关控制台 | 多模型统一入口、人民币结算 |
同一个词在不同平台指的不是同一种东西。云厂商的 IAM 凭证不能贴到 OpenAI SDK 的 api_key 里;推理平台的 Key 通常也不能调用另一家的模型。先确认凭证类型,再谈“获取”。
二、官方路线:Meta 的 Llama API Key 已成历史
Meta 在 2025 年推出 Llama API 公共预览,提供 api.llama.com 的托管入口和 OpenAI 兼容路径。该预览已于 2026 年 7 月 6 日下线,旧请求会收到服务终止提示或重定向指引,旧 Key 通常不再可用。看到“去 Meta 控制台创建 Llama API Key”的教程,先确认它的发布日期。
需要区分两件事:模型权重和托管 API。Llama 的开放权重仍按 Llama 社区许可证提供,可从 Meta 的模型页面和 Hugging Face 获取;下线的是 Meta 的第一方托管层。Meta 目前主推的 Meta Model API 提供的是 Muse 系列模型,不是 Llama,两者不要混用。
因此,今天所谓“官方 Key”只剩两种含义:一是从官方渠道下载权重后自建,鉴权由你自己实现;二是通过云厂商或托管商调用。任何声称能开通“Meta Llama API 官方 Key”的第三方页面,都应先核实。
三、云厂商:拿到的是 IAM 凭证,不是粘贴式 Key
AWS Bedrock。 先在控制台申请模型访问权限,再给调用方配置 bedrock:InvokeModel 和 bedrock:InvokeModelWithResponseStream 等最小权限。调用使用 SigV4 签名,通常由 SDK 或临时凭证完成,不需要把长期 Key 写进代码。以 Llama 4 Scout 为例,Bedrock 当前只支持 Invoke 或 Converse API,不提供 Chat Completions 入口;模型 ID 形如 meta.llama4-scout-17b-instruct-v1:0,跨区域推理还要加 us. 之类的前缀,不同区域和生命周期的可用性也不同。
Microsoft Foundry(原 Azure AI Foundry)。 在模型目录中部署 Llama 模型后,使用资源端点加 Key,或改用 Entra ID 身份。Key 与资源绑定,换订阅或换区域要重新确认。
Google Cloud Vertex AI。 通过服务账号或应用默认凭证调用,给账号授予 Vertex AI 相关角色,并确认项目、区域和模型版本。注意生命周期:Google 已公告 llama-3.3-70b-instruct-maas 于 2026 年 10 月 21 日退役,仍在使用的团队需要迁移或改为自部署。
云厂商路线的共同点是权限粒度细、审计链完整,但开通慢、账单科目多。Key 不要发给个人,应该绑定工作负载身份,并限制来源网络和可用区域。
四、推理平台与兼容网关:最常见的 Bearer Key
Groq、OpenRouter、Fireworks 等推理平台,以及国内 OpenAI 兼容网关,通常提供一个控制台,在 API Keys 页面创建 Bearer Token。创建步骤大同小异:
- 注册账号,按平台要求完成邮箱、手机号或企业认证。
- 进入 API Keys 页面,新建 Key,名称写清项目、环境和使用者,例如
prod-rag-cn。 - 选择最小权限:只开推理权限,不开账单、成员管理或 Key 管理权限。
- 设置预算、速率或月度上限,避免单个 Key 跑穿账户。
- 复制后立即存入密码管理器或密钥管理服务;多数平台只在创建时显示一次。
- 用一条最小请求验证 Key、Base URL 和模型名,再写入正式配置。
网关的差异在于一把 Key 可能对应多个上游模型。以中商起航 AI 网关为例,Base URL 是 https://ai.zhongshangqihang.com/v1,具体可用模型以控制台和模型价格页面为准。好处是统一账单和日志,代价是多一层转发,选型时要确认数据路径、故障处理和计费口径。
五、权限:Key 不是越全能越好
把 Key 当成身份,而不是密码。生产、测试、个人实验各用一把;前端、移动端和公开仓库里不出现长期 Key;需要浏览器直连时,走短期令牌或后端代理。能给 IP 白名单、来源域名、模型范围或预算上限的平台,都把限制加上。
团队里常见的反模式是“一把 Key 所有人用”。出问题时无法定位是谁调的,泄露后也无法只吊销一个人。按项目拆 Key,配合用量标签和告警,排查成本会低很多。
六、环境变量与代码:别让 Key 进 Git
# .env 只放在本机或密钥管理服务,不要提交到 Git
export LLAMA_API_KEY="你的密钥"
export LLAMA_BASE_URL="https://api.groq.com/openai/v1"
export LLAMA_MODEL="llama-3.3-70b-versatile"
Python、Node 等 SDK 常在未显式传参时读取 OPENAI_API_KEY。如果同一进程里还调用其他厂商,建议显式传入 api_key,避免把 A 平台的 Key 发到 B 平台。容器和 systemd 服务要确认环境变量真的注入,而不是只在当前 shell 生效。
401 排查按顺序看:
- 请求头是否为
Authorization: Bearer <key>,Bearer后有一个空格。 - Key 是否来自当前 Base URL 对应的平台,跨平台 Key 不通用。
- Key 是否被吊销、过期,或创建后从未启用。
- 环境变量是否带上了引号、换行或复制时混入的空格。
- 服务进程是否读到了旧变量,修改后是否重启。
- 401 是身份未通过,403 多是身份通过但权限不足,不要混为一谈。
七、轮换与吊销:把退出路径先设计好
- 在平台创建新 Key,命名带日期,例如
prod-2026-10。 - 先在一个测试服务或灰度实例替换,观察 401、403 和延迟。
- 确认日志中没有鉴权失败,再逐步替换其余环境。
- 保留新旧 Key 重叠一段时间,但不要超过一个发布周期。
- 确认旧 Key 无调用后吊销,并检查近期用量是否异常。
- 更新密钥台账:创建时间、负责人、用途、下次轮换日期。
触发轮换的事件包括人员离职、Key 出现在日志或仓库、供应商安全事件,以及固定的周期轮换。怀疑泄露时先吊销再排查,不要先改代码;同时检查账单和调用日志,确认没有异常模型或异常地域的请求。
常见问题
现在还能申请 Meta 官方的 Llama API Key 吗?
不能。Meta 的 Llama API 公共预览已于 2026 年 7 月 6 日下线,旧入口不再提供推理服务。Llama 权重仍可下载,托管调用需要通过云厂商、推理平台或兼容网关。
云厂商为什么没有可以直接粘贴的 API Key?
云厂商通常用 IAM 角色、服务账号或临时凭证做鉴权,权限和审计绑定在云账户上。这样比长期 Bearer Token 更细粒度,但接入时要先配置权限和签名,不能直接套用 OpenAI SDK 的 api_key 参数。
一把 Key 能调用所有 Llama 模型吗?
取决于平台。推理平台和网关通常一把 Key 可调用账户下已开通的多个模型;云厂商则受 IAM 权限、模型访问申请和区域限制。模型是否可用,以控制台当前列表为准。
Key 放在前端或 App 里会怎样?
等于公开。抓包就能拿到并消耗你的额度。浏览器和移动端应调用自己的后端,由后端持有 Key 并做鉴权、限额和日志。
401 和 403 应该先查什么?
401 先查 Key 本身、请求头格式和 Base URL 是否匹配;403 先查该 Key 或角色是否拥有目标模型、项目或区域的权限。两个错误都排查完,再看网关或云厂商的状态页。
下一步
先确定接入路线,再创建一把专用 Key:云厂商走 IAM,推理平台和网关走 Bearer Token,自建则设计自己的鉴权。需要统一 Key、日志和多模型入口,可以从注册中商起航 AI 网关开始;可用模型与计费口径以模型价格为准。
相关阅读:
