“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。创建步骤大同小异:

  1. 注册账号,按平台要求完成邮箱、手机号或企业认证。
  2. 进入 API Keys 页面,新建 Key,名称写清项目、环境和使用者,例如 prod-rag-cn。
  3. 选择最小权限:只开推理权限,不开账单、成员管理或 Key 管理权限。
  4. 设置预算、速率或月度上限,避免单个 Key 跑穿账户。
  5. 复制后立即存入密码管理器或密钥管理服务;多数平台只在创建时显示一次。
  6. 用一条最小请求验证 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 多是身份通过但权限不足,不要混为一谈。

七、轮换与吊销:把退出路径先设计好

  1. 在平台创建新 Key,命名带日期,例如 prod-2026-10。
  2. 先在一个测试服务或灰度实例替换,观察 401、403 和延迟。
  3. 确认日志中没有鉴权失败,再逐步替换其余环境。
  4. 保留新旧 Key 重叠一段时间,但不要超过一个发布周期。
  5. 确认旧 Key 无调用后吊销,并检查近期用量是否异常。
  6. 更新密钥台账:创建时间、负责人、用途、下次轮换日期。

触发轮换的事件包括人员离职、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 网关开始;可用模型与计费口径以模型价格为准。

相关阅读: