---
title: Grok Build에서 RunAPI 사용 — 사용자 지정 모델 구성 가이드 | RunAPI
description: xAI가 문서화한 사용자 지정 모델 필드, 환경 변수 API 키, RunAPI 모델 가이드로 Grok Build를 구성합니다.
url: https://runapi.ai/ko/grok-build.md
canonical: https://runapi.ai/ko/grok-build
locale: ko
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/grok-build
  zh-CN: https://runapi.ai/zh-CN/grok-build
  es: https://runapi.ai/es/grok-build
  ja: https://runapi.ai/ja/grok-build
  de: https://runapi.ai/de/grok-build
  fr: https://runapi.ai/fr/grok-build
  pt-BR: https://runapi.ai/pt-BR/grok-build
  ko: https://runapi.ai/ko/grok-build
  it: https://runapi.ai/it/grok-build
  nl: https://runapi.ai/nl/grok-build
  pl: https://runapi.ai/pl/grok-build
  tr: https://runapi.ai/tr/grok-build
  zh-TW: https://runapi.ai/zh-TW/grok-build
  zh-HK: https://runapi.ai/zh-HK/grok-build
  ar: https://runapi.ai/ar/grok-build
  x-default: https://runapi.ai/grok-build
---

> HTML version: https://runapi.ai/ko/grok-build
> Site index for agents: https://runapi.ai/llms.txt


# Grok Build에서 RunAPI 사용.

Grok Build는 base_url과 env_key를 통한 사용자 지정 모델 구성을 지원합니다. 문서화된 TOML 형식을 RunAPI에 연결하고 키를 RUNAPI_API_KEY에 보관한 뒤 카탈로그 모델 가이드를 선택합니다.

- [API 키 받기](https://runapi.ai/ko/login)
- [모델 찾아보기](https://runapi.ai/ko/models.md)

> 이 페이지는 공식 구성 사실과 실행 증거를 구분합니다. 이번 작업에서는 유료 upstream 요청이나 실제 Grok Build 세션을 실행하지 않았으므로 예시는 추론 성공을 의미하지 않습니다.

## config.toml

```toml
[model.runapi]
model = "gpt-5.5"
name = "RunAPI GPT 5.5"
base_url = "https://runapi.ai/v1"
env_key = "RUNAPI_API_KEY"

[models]
default = "runapi"
```

## 명령어

```bash
export RUNAPI_API_KEY="runapi_xxx"
grok --version
grok
```

## 문서화된 사용자 지정 모델 형식 구성

1. **환경에 API 키 설정** — Grok Build를 실행하는 동일한 환경에서 RUNAPI_API_KEY를 내보냅니다. 실제 키를 config.toml이나 소스 코드에 넣지 마세요. `export RUNAPI_API_KEY="runapi_xxx"`
2. **RunAPI 모델 항목 추가** — xAI가 문서화한 model, name, base_url, env_key 필드를 사용하고 default가 이름 있는 모델 항목을 가리키게 합니다. `[model.runapi]`
3. **세션 전에 로컬 검토** — 설치된 CLI 버전을 확인하고 생성된 구성을 로컬에서 검사합니다. 로컬 검사는 RunAPI 요청이나 모델 응답을 증명하지 않습니다. `grok --version`

## Grok Build용 RunAPI 모델 선택

가이드 목록은 RunAPI 카탈로그에서 가져옵니다. 각 가이드는 현재 모델 ID와 공개 endpoint를 보여 주며 모든 카탈로그 변형이 Grok Build에서 실제 검증되었다고 약속하지 않습니다.

- [GPT](https://runapi.ai/ko/grok-build-gpt.md) — 텍스트 · OpenAI

## Grok Bot은 Cursor가 호스팅하는 별도 제품입니다.

xAI의 Grok Bot 문서는 Grok Bot을 Cursor에 연결된 제품으로 설명하며, Bot은 영구 클라우드 컴퓨터에서 실행됩니다. Grok Bot 문서에는 Grok Build에 대해 문서화된 사용자 지정 base_url 설정이나 모델 선택 기능이 없습니다. 따라서 이 페이지는 Grok Bot이 RunAPI를 통해 라우팅된다고 약속하지 않습니다.

[Grok Bot 공식 문서 읽기](https://docs.x.ai/grok-bot/overview)

## 구성 필드

| 필드 | 값 | 용도 |
| --- | --- | --- |
| `model.runapi.model` | `gpt-5.5` | 사용자 지정 항목에서 사용할 RunAPI 카탈로그 모델을 선택합니다. |
| `model.runapi.base_url` | `https://runapi.ai/v1` | 문서화된 OpenAI 호환 base URL을 RunAPI로 지정합니다. |
| `model.runapi.env_key` | `RUNAPI_API_KEY` | 자격 증명을 코드에 하드코딩하지 않고 환경에서 읽습니다. |
| `models.default` | `runapi` | 이름 있는 사용자 지정 모델 항목을 기본값으로 선택합니다. |

## Grok Build 구성 질문

### 이 페이지는 Grok Build가 RunAPI 추론을 완료했다고 주장하나요?

아니요. TOML 형식은 xAI의 공개 Grok Build 문서를 따릅니다. 실제 RunAPI 요청에는 별도 승인을 받은 런타임 검사가 필요하며 이번 작업에서는 유료 요청을 실행하지 않았습니다.
### RunAPI 키는 어디에 저장해야 하나요?

Grok Build를 시작하는 환경에 RUNAPI_API_KEY를 설정합니다. env_key 필드는 로컬 구성이 읽을 변수를 지정합니다.
### Grok Bot이 이 구성을 자체 모델 선택기로 사용할 수 있나요?

그런 주장은 하지 않습니다. xAI의 Grok Bot 문서는 Cursor가 관리하는 모델을 설명하며 고객이 제어하는 base_url이나 모델 선택기를 문서화하지 않습니다.

## 공식 출처

- [Grok Build official documentation](https://docs.x.ai/build/overview)
- [xAI API models](https://docs.x.ai/developers/models)

RunAPI 계정을 만들거나 로그인해 현재 모델 카탈로그를 확인하세요. 실행 검증은 이 공개 구성 참고자료와 별도로 진행해야 합니다.


---

## More from RunAPI

- [Home](https://runapi.ai/ko/.md)
### 제품
- [모델 카탈로그](https://runapi.ai/ko/models.md)
- [요금](https://runapi.ai/ko/pricing.md)
- [제공사](https://runapi.ai/ko/models#all-models)
### 개발자
- [문서](https://runapi.ai/ko/docs/guides)
- [SDK](https://runapi.ai/ko/sdk.md)
- [CLI](https://runapi.ai/ko/cli.md)
- [MCP Server](https://runapi.ai/ko/mcp.md)
- [x402](https://runapi.ai/ko/x402.md)
### 가이드
- [Claude Code와 Cursor](https://runapi.ai/ko/claude-code-vs-cursor.md)
- [Cursor API 설정](https://runapi.ai/ko/cursor-api-setup.md)
- [RunAPI와 OpenRouter 비교](https://runapi.ai/ko/openrouter-alternative.md)
### 회사
- [엔터프라이즈](https://runapi.ai/ko/contact.md)
- [문의](https://runapi.ai/ko/contact.md)
### 법적 고지
- [약관](https://runapi.ai/ko/terms.md)
- [개인정보](https://runapi.ai/ko/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ko/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ko",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/koicon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "SoftwareApplication",
    "name": "RunAPI",
    "applicationCategory": "DeveloperApplication",
    "description": "xAI가 문서화한 사용자 지정 모델 필드, 환경 변수 API 키, RunAPI 모델 가이드로 Grok Build를 구성합니다.",
    "url": "https://runapi.ai/ko/grok-build"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "이 페이지는 Grok Build가 RunAPI 추론을 완료했다고 주장하나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "아니요. TOML 형식은 xAI의 공개 Grok Build 문서를 따릅니다. 실제 RunAPI 요청에는 별도 승인을 받은 런타임 검사가 필요하며 이번 작업에서는 유료 요청을 실행하지 않았습니다."
        }
      },
      {
        "@type": "Question",
        "name": "RunAPI 키는 어디에 저장해야 하나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "Grok Build를 시작하는 환경에 RUNAPI_API_KEY를 설정합니다. env_key 필드는 로컬 구성이 읽을 변수를 지정합니다."
        }
      },
      {
        "@type": "Question",
        "name": "Grok Bot이 이 구성을 자체 모델 선택기로 사용할 수 있나요?",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "그런 주장은 하지 않습니다. xAI의 Grok Bot 문서는 Cursor가 관리하는 모델을 설명하며 고객이 제어하는 base_url이나 모델 선택기를 문서화하지 않습니다."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "HowTo",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "환경에 API 키 설정",
        "text": "Grok Build를 실행하는 동일한 환경에서 RUNAPI_API_KEY를 내보냅니다. 실제 키를 config.toml이나 소스 코드에 넣지 마세요."
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "RunAPI 모델 항목 추가",
        "text": "xAI가 문서화한 model, name, base_url, env_key 필드를 사용하고 default가 이름 있는 모델 항목을 가리키게 합니다."
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "세션 전에 로컬 검토",
        "text": "설치된 CLI 버전을 확인하고 생성된 구성을 로컬에서 검사합니다. 로컬 검사는 RunAPI 요청이나 모델 응답을 증명하지 않습니다."
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ko",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "홈",
        "item": "https://runapi.ai/ko"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "RunAPI",
        "item": "https://runapi.ai/ko/grok-build"
      }
    ]
  }
]
```
