Grok을 웹에서 채팅으로만 쓰다 보면 한계가 옵니다. 내 프로그램에서 그록 API를 직접 호출하면 자동화 워크플로우에 Grok 모델을 끼워 넣을 수 있습니다. 이 글에서는 xAI 콘솔에서 API 키를 발급받는 것부터 모델별 가격, 이미지·영상 API 호출까지 실제 화면을 보며 정리합니다.
xAI API란
xAI API는 Grok 모델을 HTTP 요청으로 호출할 수 있게 해주는 인터페이스입니다. 기본 엔드포인트는 https://api.x.ai이고, OpenAI 호환 형식을 따르기 때문에 기존에 OpenAI SDK를 쓰던 코드에서 base URL만 바꾸면 대부분 동작합니다.
콘솔 좌측 메뉴를 보면 Code, Chat, Image, Video, Voice 등 API 카테고리가 나뉘어 있습니다. 텍스트 생성뿐 아니라 이미지 생성, 음성 변환까지 하나의 API 키로 접근할 수 있다는 뜻입니다.
그록 API 키 발급
키 발급은 xAI 콘솔(console.x.ai)에서 진행합니다.
- 콘솔 메인 화면 우측 상단의 Get API Key 버튼을 클릭합니다.
- “Create API Key” 팝업이 뜨면 키 이름을 입력하고 Create API key 버튼을 누릅니다.
- 생성된 키가 한 번만 표시됩니다. 이 시점에 복사해 안전한 곳에 저장하세요.
키를 분실하면 재확인이 불가능합니다. 환경 변수나 시크릿 매니저에 바로 저장하는 습관을 들이세요.
기본 인증과 첫 요청
발급받은 키는 HTTP 헤더에 Bearer 토큰으로 넣습니다. curl로 첫 요청을 보내보겠습니다.
bash curl -s https://api.x.ai/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $XAI_API_KEY" \ -d '{ "model": "grok-4.6", "messages": [ {"role": "user", "content": "안녕, 간단히 자기소개 해줘"} ] }'
응답은 OpenAI 형식과 동일하게 choices[0].message.content에 답변이 담겨 옵니다. Python이라면 openai 라이브러리의 base_url을 https://api.x.ai/v1로 지정하면 됩니다.
현재 사용 가능한 Grok 모델
콘솔 Models 페이지에서 현재 제공되는 모델 목록을 확인할 수 있습니다.
주요 모델을 정리하면 다음과 같습니다.
| 카테고리 | 모델명 | 컨텍스트 | 특징 |
|---|---|---|---|
| Code/Chat | Grok 4.6 | 500K | 플래그십. Tool calling, Reasoning, Vision 지원 |
| Code/Chat | Grok Build 0.1 | 256K | 빠른 코딩 특화 모델 |
| Chat | Grok 4.3 | 1M | 대화 특화, 긴 컨텍스트 |
| Image | Grok Imagine Image 2.0 | — | 생성·편집, 1K/2K 해상도 |
| Image | Grok Imagine Image Quality | — | 고품질 생성·편집 |
| Voice | Voice Agents | — | 실시간 음성 대화 |
Grok 4.6 호출
Grok 4.6은 xAI의 최신 플래그십 모델입니다. 모델 ID는 grok-4.6이고, 500K 토큰 컨텍스트를 지원합니다. agentic tool calling, 구조화된 출력, 비전(이미지 입력), 설정 가능한 추론(reasoning)을 모두 지원합니다.
요청 시 model 파라미터에 "grok-4.6"을 넣으면 됩니다. 이전 버전인 Grok 4.3은 "grok-4.3"으로, 빠른 코딩 모델은 "grok-build-0.1"로 지정합니다.
그록 API 가격: 모델별 토큰 단가
가격은 1M(백만) 토큰 단위로 과금됩니다.
텍스트 모델
| 모델 | Input | Cached Input | Output |
|---|---|---|---|
| Grok 4.6 | $2.00 / 1M tokens | $0.50 / 1M tokens | $6.00 / 1M tokens |
| Grok Build 0.1 | $1.00 / 1M tokens | $0.20 / 1M tokens | $2.00 / 1M tokens |
이미지 모델
| 모델 | Input | Output |
|---|---|---|
| Grok Imagine Image 2.0 | $0.01 / img | $0.04 / img |
| Grok Imagine Image Quality | $0.01 / img | $0.05 / img |
Voice API
| 기능 | 가격 |
|---|---|
| Agent | $0.05 / min부터 |
| TTS | $15.00 / 1M chars |
| STT (Batch) | $0.10 / hour |
| STT (Streaming) | $0.20 / hour |
Imagine API (영상)
| 기능 | 가격 |
|---|---|
| Image (1K / 2K) | $0.02 / image부터 |
| Video (480p / 720p / 1080p) | $0.05 / sec부터 |
토큰 과금 이해
API 과금의 기본 단위는 토큰입니다. 한국어 기준으로 한 글자가 대략 1~2 토큰에 해당합니다. 영어보다 토큰 효율이 낮으므로 한국어로 긴 프롬프트를 보낼 때는 비용이 더 나올 수 있습니다.
Cached Input 가격이 별도로 있다는 점에 주목하세요. 같은 시스템 프롬프트를 반복 호출하면 캐시가 적용되어 입력 비용이 크게 줄어듭니다. Grok 4.6 기준으로 캐시 적용 시 입력 단가가 $2.00에서 $0.50으로 75% 할인됩니다.
그록 API 이미지 생성
이미지 생성 API는 /v1/images/generations 엔드포인트를 사용합니다.
bash curl -s https://api.x.ai/v1/images/generations \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $XAI_API_KEY" \ -d '{ "model": "grok-imagine-image-2.0", "prompt": "A collage of London landmarks in a stenciled street-art style" }'
응답에는 생성된 이미지의 URL, MIME 타입, 수정된 프롬프트가 담기고, usage.cost_in_usd_ticks 필드로 실제 과금 금액을 확인할 수 있습니다. 이미지당 과금이므로 토큰 계산 없이 건당 비용을 바로 알 수 있어 예산 관리가 단순합니다.
Imagine 영상 API
Pricing 페이지에 따르면 Imagine API는 이미지뿐 아니라 영상 생성도 지원합니다. 480p, 720p, 1080p 해상도를 선택할 수 있고, 초당 $0.05부터 과금됩니다. 10초짜리 720p 영상이면 약 $0.50 수준이라고 예상할 수 있습니다.
Rate Limit 구조
xAI API의 rate limit는 모델별로 RPS(초당 요청 수)와 TPM(분당 토큰 수) 두 축으로 관리됩니다. 초당 한도는 분당 요청 수(RPM)를 60으로 나눈 값에서 파생되며, 갑작스러운 트래픽 폭주를 방지하는 역할을 합니다.
모델별 기본 rate limit (Tier 0 기준)
| 모델 | RPM | RPS | TPM |
|---|---|---|---|
| Grok 4.6 | 7,200 | 150 | 50M |
| Grok Build 0.1 | 1,800 | 37 | 10M |
| Imagine Image 2.0 | 300 | 6 | — |
| Imagine Image Quality | 300 | 6 | — |
Rate Limit 티어
티어는 2026년 1월 1일 이후 누적 사용 금액에 따라 자동으로 올라갑니다.
| 티어 | 누적 사용 금액 |
|---|---|
| Tier 0 | $0 (기본) |
| Tier 1 | $50 |
| Tier 2 | $250 |
| Tier 3 | $1,000 |
| Tier 4 | $5,000 |
| Enterprise | 별도 문의 |
처음 가입하면 Tier 0에서 시작합니다. 개인 프로젝트나 테스트 용도라면 Tier 0의 한도로도 충분하지만, 서비스에 붙일 계획이라면 누적 사용이 $50을 넘기면서 Tier 1로 자동 승급되는 구조를 알아두세요.
비용 계산 예시
실제로 얼마나 나올지 감을 잡아보겠습니다.
시나리오: Grok 4.6으로 하루 100건의 챗봇 응답을 처리한다고 가정
- 요청당 평균 입력 500 토큰, 출력 1,000 토큰
- 하루 입력: 50,000 토큰 → $0.10
- 하루 출력: 100,000 토큰 → $0.60
- 하루 총 비용: 약 $0.70, 월 약 $21
같은 시스템 프롬프트를 반복한다면 캐시가 적용돼 입력 비용이 더 줄어듭니다. 반면 Grok Build 0.1을 쓰면 같은 조건에서 월 약 $9 수준으로 내려갑니다.
오류 대응과 키 관리
API 사용 중 자주 마주치는 상황을 정리합니다.
- 401 Unauthorized: API 키가 잘못되었거나 만료된 경우. 콘솔에서 키를 재발급하세요.
- 429 Too Many Requests: rate limit 초과. 요청 간격을 늘리거나 exponential backoff을 적용하세요.
- 키 노출 사고: 키가 GitHub 등에 노출되면 즉시 콘솔에서 해당 키를 삭제하고 새로 발급하세요. 환경 변수(
XAI_API_KEY)로 관리하면 코드에 키가 직접 들어가는 것을 방지할 수 있습니다.
콘솔 좌측의 Usage 메뉴에서 실시간 사용량을 확인할 수 있고, Logs 메뉴에서 개별 요청의 성공·실패를 추적할 수 있습니다.
구독 대신 API를 써야 하는 경우
Grok 웹 구독과 API는 용도가 다릅니다. 구독은 브라우저에서 직접 대화할 때 편하고, API는 내 프로그램에 Grok을 연결할 때 필요합니다.
API가 맞는 상황은 이렇습니다.
- 자동화 파이프라인에 Grok 응답을 끼워야 할 때
- 이미지 생성을 대량으로 처리해야 할 때
- 커스텀 UI나 슬랙 봇 등에서 Grok을 호출할 때
- 사용량이 적어서 월 구독료보다 종량 과금이 더 싸게 나올 때
반대로 하루에 수십 번 직접 대화하는 정도라면 구독이 더 단순합니다. 월 $21 이하로 쓸 것 같으면 API 종량제가 유리하고, 그 이상이면 구독 플랜의 포함량과 비교해보세요.
