Skip to content

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 skip
    ```

3. **NVIDIA 모델 설정**

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


::: warning
환경 변수 대신 `--token` 전달하면 그 값이 셸 히스토리와 `ps` 출력에 남습니다.
가능하면 `NVIDIA_API_KEY` 환경 변수를 우선 사용하십시오.
:::


## 설정 예시

```json5
{
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" },
 },
},
}

내장 카탈로그

모델 ref이름컨텍스트최대 출력
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 접근을 제공하므로 소스의 cost는 기본적으로 0으로 설정됩니다.

OpenAI 호환 엔드포인트

NVIDIA는 표준 /v1 completions 엔드포인트를 사용합니다. 모든 OpenAI 호환 도구는 NVIDIA base URL과 함께 별도 설정 없이 동작해야 합니다.

TIP

NVIDIA 모델은 현재 무료로 사용할 수 있습니다. 최신 가용성 및 rate limit 세부 사항은 build.nvidia.com에서 확인하십시오.

관련 문서

모델 선택 프로바이더, 모델 ref, failover 동작 선택.

구성 레퍼런스 agent, 모델, 프로바이더에 대한 전체 구성 레퍼런스.