API Key 硬编码在代码里的第三周,我的账单和仓库一起出事了
先说三件常见的翻车事
接入 OpenAI SDK 的新手教程,十篇里有九篇让你这么写:
client = OpenAI(api_key="sk-xxxxxxxx")跑通的那一刻很爽,但接下来通常会发生三件事中的一件。
第一件:Key 被推上了公开仓库。 哪怕你在 .gitignore 里加了 .env,只要 client.py 里写死过 Key,历史提交里就永远留着。GitHub 上有爬虫专门扫描泄露的 Key,速度快到你的提醒邮件还没读完,异常调用已经开始了。
第二件:想换模型,结果全项目改了一遍。 独立开发者做产品,往往要同时用对话模型、 embedding 模型、便宜的小模型处理长尾请求。每接一家供应商就装一个 SDK、学一套接口、写一套错误处理。等你想把某个功能从 A 模型换到 B 模型时,发现调用代码散落在十几个文件里。
第三件:团队成员各自配各自的 Key。 小团队里最典型:每个人的测试 Key、生产 Key、某个成员离职后忘了轮换的 Key 混在一起。账单对不上,权限也说不清。
这三个问题的根源其实是同一个:把「代码逻辑」和「接入配置」耦合在了一起。解法也只有一个方向:配置走环境变量注入,流量走统一网关。
正确路径第一步:别直接连供应商
直接对接各家供应商,意味着你替整个团队扛下了所有接口差异和变更。更稳妥的做法是走一个兼容 OpenAI 协议的多模型网关,比如 ThisToken.AI。它对外暴露统一的 OpenAI 兼容接口,对内聚合多家模型——你换模型时只改一个模型名,代码结构不动。
注册流程很简单:打开 https://api.thistoken.ai/register ,邮箱注册后在控制台创建 API Key,复制保存。具体计费方式以官网价格页为准,这里不引用数字。
第二步:Key 进 .env,不进代码
在项目根目录建一个 .env 文件:
THISTOKEN_API_KEY=sk-你复制到的Key然后确认 .gitignore 里有这一行:
.env如果这个仓库曾经硬编码过 Key,光加 .gitignore 不够,历史提交要清理,而且那个 Key 必须去控制台作废重发。这一步偷懒,前面所有努力白费。
第三步:跑通第一段代码
安装依赖:
pip install openai python-dotenv完整可运行的示例:
import os
from dotenv import load_dotenv
from openai import OpenAI
# 从 .env 加载环境变量,Key 不出现在任何代码里
load_dotenv()
client = OpenAI(
api_key=os.environ["THISTOKEN_API_KEY"],
base_url="https://api.thistoken.ai/v1",
)
response = client.chat.completions.create(
model="gpt-4o-mini", # 模型名以网关文档列表为准
messages=[
{"role": "system", "content": "你是一个简洁的助手"},
{"role": "user", "content": "用一句话解释什么是API网关"},
],
)
print(response.choices[0].message.content)运行:
python main.py看到回答打印出来,第一段代码就跑通了。注意代码里没有出现任何明文 Key,也没有直连某家供应商的域名——base_url 指向网关,之后无论底层模型怎么换,这段初始化代码都不用动。
JavaScript 版同理:
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.THISTOKEN_API_KEY,
baseURL: "https://api.thistoken.ai/v1",
});
const res = await client.chat.completions.create({
model: "gpt-4o-mini",
messages: [{ role: "user", content: "用一句话解释什么是API网关" }],
});
console.log(res.choices[0].message.content);第四步:换模型只改一个词
接入统一网关后,切换模型就是把 model 参数换掉:
model="claude-sonnet-4" # 具体可用模型名以网关文档为准初始化逻辑、错误处理、重试封装,全都不用碰。配合把模型名也放进 .env(比如 CHAT_MODEL=gpt-4o-mini),你甚至可以在不改代码的情况下给不同环境配不同模型:开发用便宜的,生产用强的。
几条收尾建议
- 生产环境别用
.env文件,改用部署平台的环境变量注入(Vercel、Railway、Docker 的-e参数都行),原则不变:Key 只从环境来。 - 给团队成员发子 Key(如果网关支持),而不是共享一个主 Key,出问题能定位、能单独作废。
- 定期轮换。哪怕没出事,三个月换一次 Key 的成本远低于一次泄露的善后成本。
回头看,整件事的核心只有两句话:Key 永远从环境变量读取,出口永远指向同一个兼容端点。把这两件事在项目第一天做对,后面换供应商、换模型、加人,都是轻量操作。
如果还没有账号,可以从这里注册开始:https://api.thistoken.ai/register ,十分钟内就能跑通上面的第一段代码。
---
不想折腾多家供应商的接入差异?在 https://api.thistoken.ai/register 注册,用一个 base_url 调用所有模型。