如何获取 GPT-OSS API 密钥(分步指南)
作者:xander · 2025-10-14 · 阅读时间:8分钟
文章目录
一句话总结:从 0 到 1,只用 15 分钟,让任何开发者——无论身处硅谷还是三线小城——都能把 GPT-OSS 的超长上下文、MoE 架构、函数调用能力装进自己的应用。
🌌 为什么要读这篇指南?
2025 年的 AI 江湖,有三件事正在发生:
- 大模型平民化:120B 参数的 GPT-OSS 在 Novita AI 上按量付费,每百万输入 token 仅 0.1 美元。
- 接口大一统:从 Hugging Face 到 OpenRouter,所有主流平台都在拥抱 OpenAI 兼容格式。
- 开发者焦虑:API 密钥成了新时代的「SSH 公钥」,却鲜有人把申请流程讲透。
今天,我们把「申请—配置—验证—上线」四步曲拆成 15 张高清截图 + 1 张流程图 + 5 段可直接粘贴的代码,手把手带你通关。
🧭 全流程鸟瞰图
1️⃣ 选择平台:三条主流路线
路线 | 特色 | 适用场景 | 官方入口 |
---|---|---|---|
Novita AI | 免翻墙、支付宝/微信充值、120B/20B 模型任选 | 国内开发者、出海 MVP | https://novita.ai |
OpenRouter | 多模型路由、统一账单、支持 GPT-4.1/Claude 混用 | 需要 A/B 测试的企业 | https://openrouter.ai |
自建 OSS | 本地 GPU、完全离线、Apache-2.0 权重 | 数据合规敏感政企 | https://huggingface.co/openai/gpt-oss-120b |
下文以 Novita AI 为例,流程同样适用于 OpenRouter,只需替换 base_url 与 key。
2️⃣ 注册与身份验证(3 分钟)
2.1 创建账号
- 打开 Novita AI 注册页 → 选择 邮箱注册 或 Google/GitHub 一键登录。
- 输入验证码,完成 邮箱验证。
2.2 绑定手机号(中国大陆可用)
- 进入 Settings → Security → Phone
- 选择中国区 +86,输入手机号 → 接收短信验证码 → 完成绑定。
- PS:一个手机号只能绑定一个账号,如需多账户请准备副卡。
3️⃣ 充值与配额(2 分钟)
3.1 支付方式
- 支付宝/微信:即时到账,最低 1 美元。
- 国际信用卡:支持 Visa/Master,需 3D-Secure。
3.2 选择模型与价格
模型 | 上下文 | 输入 $/1M | 输出 $/1M | 推荐场景 |
---|---|---|---|---|
gpt-oss-20b | 128 K | 0.05 | 0.2 | 轻量客服、脚本生成 |
gpt-oss-120b | 128 K | 0.10 | 0.5 | 金融分析、代码审查 |
新用户赠送 5 美元 试用金,可跑 100 万输入 token。
4️⃣ 创建项目 & 生成 API Key(1 分钟)
1.右上角头像 → Access Tokens → Create new token
- 进入项目 → API Keys → Generate → 弹出 sk-nov-xxxxxx 字符串。
- 立即复制,页面刷新后将无法再查看完整 key。
5️⃣ 本地验证(30 秒)
打开终端,替换下方 YOUR_KEY_HERE
后直接回车:
curl https://api.novita.ai/v3/openai/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer sk-nov-YOUR_KEY_HERE" \
-d '{
"model": "gpt-oss-20b",
"messages": [{"role": "user", "content": "Hello GPT-OSS!"}],
"max_tokens": 20
}'
若返回 JSON 包含 "choices"
,代表密钥有效。
6️⃣ 写入环境变量(30 秒)
macOS / Linux
echo 'export NOVITA_API_KEY=sk-nov-YOUR_KEY_HERE' >> ~/.zshrc
source ~/.zshrc
Windows PowerShell
setx NOVITA_API_KEY sk-nov-YOUR_KEY_HERE
7️⃣ 代码示例:5 种语言一键复制
JavaScript(Node 20)
import OpenAI from "openai";
const openai = new OpenAI({
baseURL: "https://api.novita.ai/v3/openai",
apiKey: process.env.NOVITA_API_KEY,
});
const chat = await openai.chat.completions.create({
model: "gpt-oss-120b",
messages: [{ role: "user", content: "写一首关于夏天的俳句" }],
stream: true,
});
for await (const chunk of chat) {
process.stdout.write(chunk.choices[0]?.delta?.content || "");
}
Python(3.11)
import os
from openai import OpenAI
client = OpenAI(
base_url="https://api.novita.ai/v3/openai",
api_key=os.getenv("NOVITA_API_KEY"),
)
resp = client.chat.completions.create(
model="gpt-oss-120b",
messages=[{"role": "user", "content": "8 月 15 日历史上的三件大事"}],
max_tokens=512,
)
print(resp.choices[0].message.content)
Java(Spring Boot 3.2)
@Value("${novita.api.key}")
private String key;
@Bean
public OpenAiClient openAiClient() {
return OpenAiClient.builder()
.baseUrl("https://api.novita.ai/v3/openai")
.apiKey(key)
.build();
}
Go(1.22)
import "github.com/sashabaranov/go-openai"
client := openai.NewClientWithConfig(openai.ClientConfig{
BaseURL: "https://api.novita.ai/v3/openai",
APIKey: os.Getenv("NOVITA_API_KEY"),
})
resp, _ := client.CreateChatCompletion(context.TODO(), openai.ChatCompletionRequest{
Model: "gpt-oss-20b",
Messages: []openai.ChatCompletionMessage{
{Role: openai.ChatMessageRoleUser, Content: "用 Go 写一个并发安全的计数器"},
},
})
fmt.Println(resp.Choices[0].Message.Content)
cURL(CI/CD 友好)
curl -s https://api.novita.ai/v3/openai/chat/completions \
-H "Authorization: Bearer ${NOVITA_API_KEY}" \
-d '{"model":"gpt-oss-20b","messages":[{"role":"user","content":"ping"}]}'
🔐 安全最佳实践
风险 | 对策 |
---|---|
密钥泄露 | GitHub Actions 使用 Repository Secrets,禁止硬编码。 |
被刷额度 | 开启 IP 白名单 + 每日预算上限。 |
日志残留 | 关闭 echo $NOVITA_API_KEY ,改用 printf '%s\n' "$NOVITA_API_KEY" 。 |
📊 费用监控 & 告警
- 控制台开启 Usage Alert → 设置日消费 10 美元阈值 → 邮件 + Webhook 告警。
- 使用 Prometheus exporter 抓取账单接口,Grafana 实时大盘。
🚀 进阶:从试用到生产
8.1 灰度策略
- 20 % 流量 → GPT-OSS 120B
- 80 % 流量 → 旧模型
- 一周后对比 首 token 延迟 与 用户满意度 再全量。
8.2 自动扩缩容
- KEDA:根据 GPU 利用率自动扩容到 5 副本。
- NVIDIA Triton:同一 Pod 内多模型热切换,零停机。
🎯 常见问题速查表
现象 | 原因 | 解决 |
---|---|---|
401 Unauthorized | 密钥错误或已删除 | 重新生成并替换环境变量 |
429 Rate Limit | 并发超限 | 控制台升级套餐或排队 |
400 context_length_exceeded | 128 K 用满 | 分段或换更大模型 |
空回复 | max_tokens 过小 | 增大到 1024+ |
🏁 结语:密钥只是开始
拿到 GPT-OSS API Key 只是推开了一扇门。
真正的魔法发生在 函数调用、记忆存储、多模态融合 的下一章。
愿你把 128 K 的上下文,写成下一个 10 亿用户的日常。
热门推荐
一个账号试用1000+ API
助力AI无缝链接物理世界 · 无需多次注册
3000+提示词助力AI大模型
和专业工程师共享工作效率翻倍的秘密
热门API
- 1. AI文本生成
- 2. AI图片生成_文生图
- 3. AI图片生成_图生图
- 4. AI图像编辑
- 5. AI视频生成_文生视频
- 6. AI视频生成_图生视频
- 7. AI语音合成_文生语音
- 8. AI文本生成(中国)
最新文章
- 完整指南:如何在应用程序中集成和使用ChatGPT API
- Amazon Bedrock × Stability AI:直播配图API批量渲染7天训练营
- InterSystems IRIS 2022.2 使用 JWT 保护 REST API 教程
- API分析 – 什么是 API 分析?
- 天文信息检索服务:如何让星空探索变得触手可及?
- 如何使用DBAPI快速搭建自己的API平台
- Workers AI合作模型助力短剧制作平台脚本生成API实战
- 如何获取 GPT-OSS API 密钥(分步指南)
- 人脸识别 API 合规升级下的银行开放 API 2025 全栈实战清单
- GPT-OSS 模型驱动在线编程课 AI 助教,3 天打造追问式对话 API
- Kimi K2-0905 256K上下文API状态管理优化:长流程复杂任务实战
- Go工程化(四) API 设计上: 项目结构 & 设计