NVIDIA API Catalog 免费额度与 API Key 获取记录
简介
NVIDIA API Catalog 是 NVIDIA 提供的模型体验与 API 调用入口，入口地址是 build.nvidia.com。它把许多模型包装成 NVIDIA NIM API，适合用来做原型验证、代码测试和个人学习。
简单理解就是：不用自己准备 GPU，也能先通过 NVIDIA 托管的接口试用部分大模型。等项目验证得差不多，再考虑换成自己的模型服务、其他 API 平台，或者部署自托管 NIM。
需要注意的是，免费额度、可用模型和调用限制会随账号地区、活动和平台政策变化，实际情况以控制台显示为准。
准备工作
开始之前需要准备：
- 一个 NVIDIA 账号
- 可以正常访问 NVIDIA API Catalog 的网络环境
- 一个用于保存 API Key 的安全位置，例如密码管理器或本地环境变量
- 可选：OpenAI 兼容客户端，例如 NextChat、LobeChat、Cherry Studio、Open WebUI 等
获取 API Key
1. 打开模型目录
访问 https://build.nvidia.com/，登录自己的 NVIDIA 账号。进入页面后，可以在模型目录里搜索想要试用的模型，也可以直接从分类里挑一个聊天模型。
如果只是测试接口是否正常，建议先选一个通用聊天模型，不必一开始就纠结具体模型强弱。
2. 进入模型详情页
点击模型后进入详情页。页面通常会提供在线预览、调用示例和 API Key 入口。部分第三方模型第一次使用时可能需要确认使用条款，按页面提示继续即可。
3. 点击 Get API Key
在模型详情页右侧找到 Get API Key。如果账号还没有完成注册或登录，页面会先引导你加入 NVIDIA Developer Program 或完成账号验证。
生成后立刻复制并保存。API Key 属于敏感凭据，不要发给别人，也不要直接写进公开仓库。
官方文档里也提供了另一种方式：进入 NGC API Keys 页面生成 Personal Key，并在服务范围里选择 NGC Catalog 和 Public API Endpoints。如果模型页生成失败，可以尝试这个入口：
API 调用配置参考
NVIDIA 托管的 NIM API 使用 OpenAI 兼容格式，所以很多支持自定义 OpenAI 接口的客户端都可以直接配置。
常用配置如下：
| 配置项 | 填写内容 |
|---|---|
| API Base URL | https://integrate.api.nvidia.com/v1 |
| API Key | 刚刚生成的 NVIDIA API Key |
| Model | 模型详情页或代码示例里的模型 ID |
| Chat API | /v1/chat/completions |
模型 ID 不建议手打，可以直接从 NVIDIA 页面给出的代码示例里复制，避免因为大小写、横线或下划线写错导致请求失败。
curl 测试
可以先用 curl 验证 Key 和模型是否可用。下面的 MODEL_ID 需要换成模型详情页显示的真实模型名：
export NVIDIA_API_KEY="你的 API Key"export MODEL_ID="模型 ID"
curl https://integrate.api.nvidia.com/v1/chat/completions \ -H "Authorization: Bearer $NVIDIA_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "'"$MODEL_ID"'", "messages": [ { "role": "user", "content": "用一句话介绍 NVIDIA NIM。" } ], "temperature": 0.6, "max_tokens": 256 }'如果能返回模型回复，说明 API Key、Base URL 和模型名都没有问题。
OpenAI SDK 调用示例
因为接口兼容 OpenAI 格式，所以可以用 OpenAI SDK 指向 NVIDIA 的 Base URL：
from openai import OpenAI
client = OpenAI( base_url="https://integrate.api.nvidia.com/v1", api_key="你的 API Key",)
response = client.chat.completions.create( model="模型 ID", messages=[ {"role": "user", "content": "写一个三句话的 Python 学习计划。"} ], temperature=0.6, max_tokens=512,)
print(response.choices[0].message.content)实际使用时建议把 API Key 放到环境变量里，不要硬编码在脚本中：
export NVIDIA_API_KEY="你的 API Key"第三方客户端配置
以常见聊天客户端为例，通常新增一个 OpenAI 兼容服务，然后填写：
- 接口地址：
https://integrate.api.nvidia.com/v1 - 密钥：NVIDIA API Key
- 模型：从 build.nvidia.com 的模型页复制
如果客户端要求填写完整接口地址，不要重复添加 /chat/completions。大多数客户端只需要 Base URL，它会自己拼接请求路径。
常见问题
提示 401 或 Unauthorized
优先检查 API Key 是否复制完整，前后有没有多余空格。如果 Key 过期或被轮换，需要重新生成并更新客户端配置。
提示模型不存在
通常是模型 ID 写错，或者该模型不支持当前账号调用。回到模型详情页复制官方示例里的模型名再试。
能在网页里试用，但客户端不能用
检查客户端是否真的使用了 OpenAI 兼容接口，以及 Base URL 是否写成 https://integrate.api.nvidia.com/v1。有些客户端会默认把 OpenAI 官方地址写死，需要改成自定义服务商。
免费额度用完怎么办
免费额度主要适合测试和学习，不建议把它当作长期生产服务。额度用完后，可以等待平台策略刷新、申请企业试用，或者迁移到其他兼容 OpenAI 的模型服务。
安全提醒
- 不要把 API Key 提交到 GitHub、博客源码或截图里。
- 不要把自己的 Key 分享给陌生人使用。
- 如果怀疑 Key 泄露，立即删除或轮换。
- 重要项目建议给不同用途创建不同 Key，方便排查和回收。
- 免费接口适合开发验证，不适合直接承载稳定线上业务。