所有文章 > 学习各类API > 如何获取 GPT-OSS API 密钥(分步指南)
如何获取 GPT-OSS API 密钥(分步指南)

如何获取 GPT-OSS API 密钥(分步指南)

一句话总结:从 0 到 1,只用 15 分钟,让任何开发者——无论身处硅谷还是三线小城——都能把 GPT-OSS 的超长上下文、MoE 架构、函数调用能力装进自己的应用。


🌌 为什么要读这篇指南?

2025 年的 AI 江湖,有三件事正在发生:

  1. 大模型平民化:120B 参数的 GPT-OSSNovita AI 上按量付费,每百万输入 token 仅 0.1 美元。
  2. 接口大一统:从 Hugging Face 到 OpenRouter,所有主流平台都在拥抱 OpenAI 兼容格式
  3. 开发者焦虑: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 创建账号

  1. 打开 Novita AI 注册页 → 选择 邮箱注册Google/GitHub 一键登录
  2. 输入验证码,完成 邮箱验证

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

  1. 进入项目 → API Keys → Generate → 弹出 sk-nov-xxxxxx 字符串。
  2. 立即复制,页面刷新后将无法再查看完整 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"

📊 费用监控 & 告警

  1. 控制台开启 Usage Alert → 设置日消费 10 美元阈值 → 邮件 + Webhook 告警。
  2. 使用 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 亿用户的日常。

#你可能也喜欢这些API文章!

我们有何不同?

API服务商零注册

多API并行试用

数据驱动选型,提升决策效率

查看全部API→
🔥

热门场景实测,选对API

#AI文本生成大模型API

对比大模型API的内容创意新颖性、情感共鸣力、商业转化潜力

25个渠道
一键对比试用API 限时免费

#AI深度推理大模型API

对比大模型API的逻辑推理准确性、分析深度、可视化建议合理性

10个渠道
一键对比试用API 限时免费