Skip to content

NVIDIA

NVIDIA 在 https://integrate.api.nvidia.com/v1 提供了一個與 OpenAI 相容的 API,可免費用於開放模型。請使用來自 build.nvidia.com 的 API 金鑰進行驗證。

  1. 取得您的 API 金鑰

    build.nvidia.com 建立 API 金鑰。

  2. 匯出金鑰並執行入門設定

    bash export NVIDIA_API_KEY="nvapi-..." openclaw onboard --auth-choice nvidia-api-key

  3. 設定 NVIDIA 模型

    bash openclaw models set nvidia/nvidia/nemotron-3-super-120b-a12b

對於非互動式設定,您也可以直接傳遞金鑰:

Terminal window
openclaw onboard --auth-choice nvidia-api-key --nvidia-api-key "nvapi-..."
{
env: { NVIDIA_API_KEY: "nvapi-..." },
models: {
providers: {
nvidia: {
baseUrl: "https://integrate.api.nvidia.com/v1",
api: "openai-completions",
},
},
},
agents: {
defaults: {
model: { primary: "nvidia/nvidia/nemotron-3-super-120b-a12b" },
},
},
}
模型參考名稱內容長度最大輸出
nvidia/nvidia/nemotron-3-super-120b-a12bNVIDIA Nemotron 3 Super 120B262,1448,192
nvidia/moonshotai/kimi-k2.5Kimi K2.5262,1448,192
nvidia/minimaxai/minimax-m2.5Minimax M2.5196,6088,192
nvidia/z-ai/glm5GLM 5202,7528,192
自動啟用行為

當設定 NVIDIA_API_KEY 環境變數時,提供者會自動啟用。 除了金鑰之外,不需要明確的提供者設定。

目錄與定價

內建的目錄是靜態的。由於 NVIDIA 目前為列出的模型提供免費 API 存取,因此來源中的成本預設為 0

OpenAI 相容端點

NVIDIA 使用標準的 /v1 完成端點。任何與 OpenAI 相容的工具應該都能直接與 NVIDIA 基礎 URL 搭配使用。

Slow custom provider responses

部分 NVIDIA 託管的客製化模型在發出第一個回應區塊之前,可能需要比預設模型閒置監視器更長的時間。對於客製化的 NVIDIA 提供者項目,請增加提供者的逾時時間,而不是增加整個 Agent 的執行時間逾時設定:

{
models: {
providers: {
"custom-integrate-api-nvidia-com": {
baseUrl: "https://integrate.api.nvidia.com/v1",
api: "openai-completions",
apiKey: "NVIDIA_API_KEY",
timeoutSeconds: 300,
},
},
},
agents: {
defaults: {
models: {
"custom-integrate-api-nvidia-com/meta/llama-3.1-70b-instruct": {
params: { thinking: "off" },
},
},
},
},
}

Model selection

選擇提供者、模型參照和故障轉移行為。

Configuration reference

針對 Agent、模型和提供者的完整設定參考。