AI API Key 获取、配置与安全管理：环境变量、Key 隔离与泄露处置

AI API Key 用来证明“这次请求是谁发的、该记在谁的账上”。它同时承担身份认证、权限控制和用量计费三件事。Key 一旦落到别人手里，别人可以直接用你的额度。

结论先放在前面：

Key 不写进代码，不进代码仓库，不下发到浏览器或手机 App。
本地开发用环境变量或 .env 文件，并把 .env 加进 .gitignore。生产环境用部署平台的 Secrets 或专门的密钥管理系统注入。
不同环境、不同业务各用一把 Key。哪把出了问题就单独吊销哪把，不影响其他服务。
发现泄露时先吊销，再查原因。

下面按拿到 Key 之后的实际顺序展开。

第一步：先定 Key 放在哪，再写代码

很多泄露发生在“先跑通再说”的阶段：Key 直接写在脚本里，跑通后顺手提交，仓库后来又被设成公开。OpenAI 的安全规范把这种做法列为明确禁止项，包括不要在客户端代码里硬编码，不要提交到 GitHub 这类公开仓库。

本地开发用环境变量就够了：

# macOS / Linux，写进 ~/.zshrc 或 ~/.bashrc
export NEXAIX_API_KEY="sk-..."

如果项目习惯用 .env 文件：

# .env
NEXAIX_API_KEY=sk-...

# .gitignore
.env

这里有个容易漏掉的情况：.env 如果已经被提交过一次，之后再加进 .gitignore，它也不会从历史记录里消失。这种情况应当把 Key 当作已泄露处理，处置方法见后文。

生产环境最好不要往服务器上手动放 .env。容器平台、CI/CD 和云厂商都有 Secrets 或 Secret Manager，部署时把 Key 作为环境变量注入。这样 Key 不会出现在镜像、仓库或部署脚本里，权限也能单独管控。

前端和移动端：Key 只能留在服务器

网页里的 JavaScript、打包后的 App 都能被用户拆开查看，混淆也挡不住。如果你的产品需要在前端调用模型，正确的结构是：前端调用你自己的后端，后端拿 Key 去请求模型 API。这样做还有一个好处，你可以在后端按用户做频率限制，避免单个用户把整把 Key 的配额用光。

API Key 只保存在后端，前端通过后端间接调用模型，不同环境使用不同的 Key

第二步：接入代码，只改 base_url 和 Key

目前很多模型服务都提供 OpenAI 兼容接口。接入时只需要给 SDK 配置两样东西：基础地址 base_url 和对应的 API Key，业务逻辑不用重写。

以 NexAIX 为例，端点是 https://api.nexaix.net/v1，从官方 OpenAI 接口迁移过来时只改这一行地址。模型名以模型页为准。模型清单上标明了每个模型的供给方式：开源权重模型部署在自有算力上，闭源模型走厂商官方授权渠道。选模型时可以一起确认。

Python：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["NEXAIX_API_KEY"],  # 没配置时直接报 KeyError，比静默传空值好排查
    base_url="https://api.nexaix.net/v1",
)

resp = client.chat.completions.create(
    model="<模型页上的模型名>",
    messages=[{"role": "user", "content": "ping"}],
)
print(resp.choices[0].message.content)

Node.js：

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.NEXAIX_API_KEY,
  baseURL: "https://api.nexaix.net/v1",
});

写代码之前，可以先用 curl 确认 Key 本身没问题：

curl https://api.nexaix.net/v1/chat/completions \
  -H "Authorization: Bearer $NEXAIX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"<模型页上的模型名>","messages":[{"role":"user","content":"ping"}]}'

如果返回 401，常见原因有：Key 复制时带了空格或换行，环境变量没在当前终端或进程里生效，Key 已被吊销，或者 Key 和 base_url 不是同一家服务的。最后一种在迁移时很常见：地址改了，读取的却还是旧服务的 Key。各状态码的具体排查方法可以看 AI API 错误码怎么看。

关于第三方客户端和框架：不同工具读取的环境变量名不一样。有的读 OPENAI_API_KEY 和 OPENAI_BASE_URL，有的要在设置界面里填。以工具自己的文档为准，不要假设它会自动读取你设定的变量名。