Grok 완전 가이드: 요금제, 모델, Imagine부터 xAI API와 개인정보 설정까지

이 가이드를 읽는 방법

이 문서는 일회성 튜토리얼이 아니라 계속 갱신되는 참고 문서입니다. 내용의 조회 기준일은 2026-11-06이며, 사실 관계는 xAI(공식 문서상 현재 명칭은 SpaceXSI)의 공식 페이지를 기준으로 합니다. 여기에는 x.ai, grok.com, docs.x.ai, X 고객센터, App Store와 Google Play의 스토어 페이지가 포함됩니다. 공식 페이지에서 확인할 수 없거나 공식 페이지끼리 서로 맞지 않는 부분은 “공식적으로 공개되지 않았습니다” 또는 “공식 페이지 간 내용이 일치하지 않습니다”라고 그대로 적으며, 제3자 수치로 메우지 않습니다.

Grok은 2026년에 전체가 새로 포장되었습니다. 회사 소속, 구독 요금제, 모드 메뉴, 사용량 계산 방식이 모두 바뀌었습니다. Grok에 대한 인상이 2025년의 SuperGrok, DeepSearch, Think 버튼에 머물러 있다면 대부분 맞지 않으므로 먼저 아래 대조표를 확인하세요.

Grok이란

Grok은 xAI가 개발한 AI 어시스턴트이자 모델 제품군입니다. 사용자용 진입 경로로는 grok.com, iOS와 Android 앱, X(구 Twitter)에 내장된 Grok이 있고, 개발자용으로는 API와 Grok Build 같은 도구가 별도로 있습니다. 공식 소개에 나오는 주요 특징은 다음과 같습니다.

• 대화 중에 웹과 공개 X 게시물을 검색하고 출처를 함께 표시합니다.
• 하나의 앱 안에 음성, 이미지·영상 생성(Grok Imagine), 파일 업로드, Connectors, Skills, Automations, Build가 통합되어 있습니다.
• 유료 요금제는 Grok, Grok Bot, Cursor, X Premium을 하나의 구독으로 묶습니다(3장).

xAI, SpaceX, X의 관계

이 부분은 공식 페이지에서 확인할 수 있는 내용만 적습니다.

공식 명칭도 통일되어 있지 않습니다. 웹사이트 하단에는 © 2026 SpaceX Super Intelligence LLC라고 적혀 있고 Terms와 AUP는 SpaceXSI라고 칭하지만, App Store의 저작권 표기는 여전히 © xAI Inc.이며 개발자 항목에는 X Corp.가 표시됩니다. 이 가이드는 회사를 처음 언급할 때 “xAI(공식 문서상 현재 명칭은 SpaceXSI)“라고 쓰고, 이후에는 회사를 “xAI”, 제품을 “Grok”이라고 부릅니다.

Grok과 Groq는 다릅니다

Grok은 xAI의 챗봇이자 모델이며 주소는 grok.com입니다. Groq(o가 하나 더 있는 철자)는 별개의 회사 Groq Inc.로, LPU 추론 칩과 클라우드 추론 서비스를 만들며 xAI와 관련이 없습니다. 이름이 비슷하므로 검색하거나 구독을 구매하거나 API를 연동할 때 도메인을 꼭 확인하세요.

이 가이드는 앞의 Grok만 다룹니다.

지난 1년간의 큰 변화

다음 표는 2025년에 흔했던 인식과 조회 기준일의 공식 현황을 대조한 것입니다.

이 가이드를 읽는 순서

권장 순서는 다음과 같습니다.

1. 이 장과 2장을 먼저 읽고 자신의 진입 경로와 로그인 방식을 확인합니다.
2. 3장과 4장에서 요금제, 사용량, 그리고 앱 내 모드와 모델 이름을 파악합니다.
3. 일상 대화, Imagine, 워크플로(Connectors, Skills, Automations, Build), Grok Bot은 각각 별도의 장이 있습니다.
4. 개인정보와 데이터 제어는 모든 사람에게 읽기를 권합니다. 특히 “Improve the model” 스위치와 Private Chat을 확인하세요.
5. 개발자는 API와 Grok Build 관련 장을 보세요.

각 장 끝에는 자료 출처와 조회 날짜가 있습니다. 숫자나 이름이 실제 화면에서 보는 것과 다르면 화면과 공식 페이지를 기준으로 하세요. 이것이 이 가이드를 계속 갱신해야 하는 이유이기도 합니다.

가장 쉽게 낡는 항목

다음 항목은 한두 달 안에 바뀔 수 있으므로 실행하기 전에 공식 페이지에서 다시 확인하세요.

가격 관련 안내: 미국 달러 가격은 공식 페이지에서 가져왔습니다. 새 타이완 달러 가격은 grok.com/plans가 조회 기준일에 대만에서 표시한 참고 가격이며, 프로모션과 앱 내 구매 가격은 다를 수 있습니다. 자세한 내용은 3장을 참고하세요.

자료 출처: xAI joins SpaceX, Terms of Service, Privacy Policy, Consumer FAQs, X Subscription 공지, Grok 4.5 everywhere, Grok 4.7, Grok Automations, Introducing Grok Bot, Grok Connectors, Grok Skills, Grok Imagine Image 2.0, Grok Imagine Video 1.5, Grok FAQ, About Grok(X 고객센터) (2026-11-06 조회)

진입 경로, 설치, 로그인

Grok의 진입 경로는 하나가 아닙니다. 웹, 모바일 앱, X에 내장된 Grok이 가장 많이 쓰이고, 그 밖에 Grok Bot, Grok Build, Office add-in 같은 확장 경로가 있습니다. 먼저 어느 것을 쓸지 정하세요. 진입 경로마다 적용되는 개인정보 처리방침, 요금제, 기능이 완전히 같지는 않기 때문입니다.

진입 경로 한눈에 보기

공식 자료에는 Grok Voice 3.0이 Tesla 차량 내 음성 대화를 구동한다는 내용과, OpenClaw, OpenCode, Kilo Code, Warp, Hermes Agent 같은 서드파티 도구에서 SuperGrok 또는 X Premium 구독으로 로그인할 수 있다는 내용도 있습니다. 이 두 가지는 차량과 개발자 시나리오에 가까워 이 장의 범위에 포함하지 않습니다.

웹 버전: grok.com

grok.com을 열면 바로 사용할 수 있습니다. 몇 가지 요점은 다음과 같습니다.

• 로그인하지 않아도 대화할 수 있습니다. 첫 화면 배너에는 이런 대화가 기록에 나타나지 않고 모델 학습에도 쓰이지 않는다고 적혀 있습니다. 반면 공식 소비자 FAQ는 로그인하지 않은 사용을 “익명으로 수집·보관될 수 있다”고 설명하고, 대부분의 지역(EU와 영국 제외)에서 학습 거부를 선택할 수 없다고 합니다. 두 설명이 일치하지 않으므로 개인정보 보호 요구가 높다면 먼저 개인정보와 데이터 장을 읽고 로그인 후의 설정을 기준으로 삼으세요.
• 입력창의 모드 메뉴(Fast, Auto, Expert, Heavy)는 로그인하지 않아도 보이며, 로그인이 필요한 “Premium” 항목이 따로 있습니다. 모드의 의미는 4장에 나옵니다.
• 도메인은 반드시 grok.com인지 확인하세요. 공식 FAQ에 따르면 잘못된 도메인(예: grok.x.ai)을 쓰면 Projects 같은 기능이 없습니다.

모바일 앱

두 스토어의 표기는 일치하지 않습니다. App Store의 저작권 표기는 © xAI Inc.이고 개발자 항목에는 X Corp.가 표시되는 반면, Google Play의 개발자 항목에는 SpaceX Super Intelligence가 표시됩니다. 공식 명칭이 아직 과도기에 있기 때문이며, 다운로드할 때는 스토어 이름 “Grok”과 위 표의 식별 정보로 대조하면 됩니다.

또한 공식 x.ai/grok 마케팅 페이지에는 “30+ languages”라고 적혀 있어 App Store에 표시된 언어 수와 다릅니다. 실제로 쓸 수 있는 언어는 인터페이스와 대화에서 확인하는 것이 맞으며, 보장으로 받아들이지 않는 것이 좋습니다.

X 내부의 Grok

X 내비게이션 바에서 Grok 아이콘을 누르면 사용할 수 있으며 주소는 x.com/i/grok입니다. 공식 X 고객센터에는 “Grok is available in all countries where X is available”이라고 쓰여 있고, 2026-07-22에 발표된 Grok 4.5도 X에 동시에 출시되었습니다. X 구독자는 X에서 Grok 탭을 쓸 수 있습니다.

헷갈리기 쉬운 부분이 두 가지 있습니다.

• 적용되는 규칙이 다릅니다. X에서 Grok을 쓰면 X의 개인정보 처리방침과 약관이 적용되고, grok.com과 앱에는 SpaceXSI의 것이 적용됩니다. 학습 데이터를 끄는 경로도 다르며, 개인정보와 데이터 장에서 다룹니다.
• X 고객센터의 About Grok 페이지에는 날짜가 없습니다. 내용이 여전히 xAI라는 명칭을 쓰고 있어 최신 버전이 아닐 수 있습니다.

로그인 방식

공식 FAQ에는 grok.com에서 다음 방식으로 로그인할 수 있다고 나옵니다.

X 계정 연결 경로: Settings → Account → Connect your X Account. Grok 혜택이 X 구독(The X Subscription 또는 기존 X Premium)에서 나온다면 같은 X 계정을 연결해 구독 상태를 동기화하는 것을 권장합니다.

로그인할 때 유의할 점은 다음과 같습니다.

• 로그인 방식이 서로 다를 때 계정이 어떻게 병합되는지는 공식 페이지에 설명이 없습니다. 대화 기록과 구독이 흩어지지 않도록 항상 같은 방식으로 로그인하는 것을 권장합니다.
• 구독은 구매한 플랫폼에서 관리해야 합니다. 웹에서 산 것은 웹에서, Apple이나 Google Play에서 산 것은 해당 스토어에서 취소합니다.
• 최소 연령은 만 13세(또는 거주 국가의 법정 최소 연령)이며, 13~17세는 부모 또는 보호자의 동의가 필요합니다.

대만에서 쓸 수 있나요

공식적으로 전체 “미지원 지역” 목록은 공개되어 있지 않아 인용할 수 없습니다. 조회 기준일에 직접 확인할 수 있는 증거는 다음 세 가지입니다.

1. grok.com/plans가 대만 네트워크 환경에서 **NT$**로 가격을 표시합니다. 이는 페이지가 대만을 구매 가능 지역으로 본다는 뜻입니다(가격은 3장 참고).
2. 대만 App Store에 Grok이 등록되어 있으며 중국어 이름으로 표시됩니다.
3. X 고객센터에 Grok이 X를 쓸 수 있는 모든 국가에서 제공된다고 쓰여 있습니다.

공식 AUP에는 “서비스를 제공하지 않는 지역에서 본 서비스를 제공해서는 안 된다”고만 쓰여 있고, Terms에 제재 지역 조항이 따로 있습니다. 전체 지역 목록은 공식적으로 공개되지 않았습니다.

사용상 유의 사항:

• 대만의 NT$ 가격과 프로모션은 접속 지역에 따라 표시됩니다. VPN이나 해외 네트워크를 쓰면 페이지가 다른 통화로 바뀔 수 있습니다.
• 지역마다 기능이 열리는 시점이 다를 수 있습니다. 예를 들어 Imagine의 참조 이미지와 음성 참조는 처음에 미국의 특정 요금제에서만 제공되었고, 며칠 안에 모든 등급으로 확대되었습니다.
• 호주에는 추가 약관(연령 확인과 특정 콘텐츠 제한)이 있으며, 자세한 내용은 개인정보와 데이터 장을 참고하세요.

자료 출처: Grok FAQ, Grok on the App Store(US), Grok on the App Store(대만), Grok on Google Play, About Grok(X 고객센터), Grok 4.5 everywhere, Introducing Grok Bot, Grok Build for everyone, Terms of Service, Acceptable Use Policy, grok.com/plans, Grokipedia (2026-11-06 조회)

요금제와 가격

2026-10-12부터 Grok의 신규 가입자는 모두 The X Subscription을 이용합니다. Grok, Grok Bot, Cursor, X Premium을 하나의 구독으로 묶은 것으로, Free, Plus, Premium, Super, Ultra의 다섯 단계로 나뉩니다. 기존 SuperGrok과 X Premium도 계속 쓸 수 있지만, 새 요금제로의 전환은 선택 사항이며 되돌릴 수 없습니다. 먼저 자신이 어느 세대의 요금제인지 확인해야 뒤에 나오는 사용량 규칙이 맞아떨어집니다.

미국 달러 가격

몇 가지 세부 사항은 다음과 같습니다.

• 가격에는 세금(예: VAT)이 포함되지 않습니다.
• 언제든 취소할 수 있으며, 갱신 최소 24시간 전에 취소해야 합니다.
• 공식 설명에 따르면 Premium은 기존 SuperGrok, Cursor Pro, X Premium+의 합계 월 $90에 해당하는 내용입니다.
• 공식 권장: 처음이라면 Premium으로 시작하고, 매일 agent를 쓰는 사람은 Super, 헤비 유저는 Ultra를 선택합니다. Plus는 사용량이 적은 소셜 크리에이터용입니다.
• “Grok API access”는 Plus 이상에 적혀 있지만, 공식 FAQ는 API 사용량이 표준 요금으로 별도 청구되며 요금제의 사용량 풀을 소모하지 않는다고 설명합니다. API 가격은 뒤의 API 장을 참고하세요.
• Cursor에서 쓰는 서드파티 모델(예: Claude, GPT)은 요금제에 포함되지 않으며 API 정가로 별도 청구됩니다.

팀과 기업

Teams와 Grok Business는 공식 페이지에서 별도로 설명되어 있으며, 둘의 차이와 같은 제품 라인인지 여부는 공식 페이지에 설명이 없습니다. 필요에 따라 x.ai/pricing과 x.ai/grok/business를 각각 확인하세요.

대만에서 표시되는 참고 가격

아래 표는 grok.com/plans가 2026-11-06에 대만 지역으로 표시한 가격입니다. NT$는 참고 가격입니다. 공식 페이지에는 “세금 및 기타 비용 별도”라고 표시되어 있고, 프로모션과 앱 내 구매 가격은 다를 수 있으며, 실제 금액은 결제 화면을 기준으로 합니다. 직접 가격 페이지인 x.ai/pricing은 같은 시점에 미국 달러만 표시합니다.

보충 설명:

• 미국 달러와 새 타이완 달러는 고정 환율이 아닙니다. $8은 NT$249, $30은 NT$990, $100은 NT$3,390, $200은 NT$6,690에 해당합니다.
• 월 결제 화면의 Plus 아래에 “NT$249/year”라는 문구가 함께 나오는데 연 결제의 NT$2,490과 맞지 않습니다. 공식 페이지 내부가 일치하지 않는 것이며, 이 가이드는 NT$249/월을 기준으로 합니다. 결제 전에 화면을 다시 한 번 확인하세요.
• 첫 달 50% 할인은 페이지에 그 시점에 걸려 있던 프로모션이며 변동됩니다. 장기 가격으로 보지 않는 것이 좋습니다.
• Apple App Store나 Google Play에서 앱 내 구매하는 가격은 공식적으로 별도 공개되지 않았습니다. 스토어의 구독 화면에서 확인하세요.

기존 요금제는 아직 있나요

계속 쓸 수 있지만, 공식 현행 페이지는 신규 가입자를 The X Subscription으로 안내합니다.

기존 요금제의 미국 달러 가격: 공식 현행 페이지에는 SuperGrok이나 SuperGrok Heavy의 가격표가 없습니다. 인용할 수 있는 것은 x.ai/pricing의 서술(Premium이 합계 월 $90인 SuperGrok, Cursor Pro, X Premium+를 대체한다)뿐이므로, 이 가이드는 기존 요금제의 가격을 적지 않습니다. 지금 얼마를 내고 있는지는 구독한 플랫폼의 결제 내역에서 확인하세요.

주간 사용량 풀과 top-up

유료 사용자의 사용량 체계이며 출처는 공식 Grok FAQ와 X Subscription 문서입니다.

• 새 체계는 하나의 주간 공용 사용량 풀로, Chat, Imagine, Voice, Build, Bot에 자유롭게 배분할 수 있습니다. FAQ에 따르면 2026년 6월부터 단계적으로 적용되었습니다.
• Settings → Usage에서 진행률, 제품별 비중, 초기화 시점을 볼 수 있습니다.
• Grok과 Cursor는 같은 주간 풀을 공유하며 매주 초기화됩니다.
• 다 쓰면 유료 기능이 일시 중지됩니다. 단 무료 등급의 Chat과 Voice 한도는 계속 쓸 수 있습니다(별도로 계산).
• 계속 쓰려면 Extra Usage Credits(최소 $5, 현재 웹에서만 구매 가능, 1년 후 만료, 단가가 요금제 포함분보다 높음)를 사거나 Auto Top Up(금액과 월 상한을 직접 설정)을 켤 수 있습니다.
• 720p 영상이 요금제 상한을 넘으면 자동으로 480p로 낮아집니다.

Grok Bot의 사용량에는 두 가지 설명이 있고 공식 페이지끼리 일치하지 않습니다. 서로 다른 요금제 세대에 속하기 때문입니다.

전환하기 전에 알아둘 것

공식 X Subscription 설명에 따르면 다음과 같습니다.

1. 전환은 영구적이며 고객센터도 되돌릴 수 없습니다.
2. 기존 구독은 결제 시점에 취소되고 일할 환불됩니다.
3. 기존 구독을 Apple이나 Google Play에서 샀다면 직접 스토어에서 취소해야 하며, 환불은 스토어가 결정합니다.
4. 구독은 X Subscription Corp.만 직접 판매하며 리셀러에게 권한을 주지 않습니다.
5. 기존 요금제와 새 요금제는 사용량 규칙이 다릅니다(예: 위 표의 Grok Bot). 전환 전에 새 요금제의 규칙을 확인하세요.

전환 전에 직접 확인하면 좋은 것: 현재 구독한 플랫폼, 갱신일, 연 결제 잔여 기간 여부, Grok Bot이 필요한지 여부(Plus에는 미포함).

자료 출처: The X Subscription 공지, x.ai/pricing, X Subscription 가격, X Subscription 개요, X Subscription 사용량, Grok FAQ, grok.com/plans, Grok Bot 요금제 확대, Grok Business, X Premium(X 고객센터) (2026-11-06 조회)

모드와 모델

Grok의 “모드”와 “모델”은 서로 다른 것이며, 가장 혼동하기 쉬운 부분이기도 합니다. 앱 입력창에서 고르는 것은 모드(Fast, Auto, Expert, Heavy)이고, 공식 공지가 다루는 것은 모델(Grok 4.5, 4.6, 4.7)입니다. 둘의 대응 관계는 공식 페이지에 공개되어 있지 않습니다. 이 장은 둘을 나누어 설명하고, 공식 문서가 명확히 쓰지 않은 부분은 분명하게 표시합니다.

앱 내 모드 메뉴

grok.com 입력창의 모드 메뉴는 2026-11-06에 직접 확인했을 때 네 개 항목이 있었고, 로그인하지 않아도 보입니다.

이 네 가지 모드는 Fast, Auto, Expert, Heavy입니다. 공식 공개 페이지는 각 모드의 용도를 하나씩 설명하지 않습니다.

그 밖에 로그인이 필요한 “Premium — Unlock extended capabilities” 항목이 있습니다.

이 메뉴에 대해 확실한 것과 확실하지 않은 것은 다음과 같습니다.

실무적인 권장 사항: 자신의 계정에서 인터페이스에 보이는 옵션을 기준으로 하세요. 어떤 모드를 쓸 수 있는지 확인하려면 로그인 후 메뉴에서 직접 선택해 보고, Settings → Usage로 돌아가 사용량 변화를 살펴보세요.

x.ai/grok의 제품 소개에는 “Deep reasoning — Step-by-step thinking you can follow and verify”라는 문구와, 여러 agent가 병렬로 처리하고 추론 과정을 감사할 수 있는 Multi-agent 기능도 나옵니다. 하지만 이것이 위의 어느 모드나 어느 요금제에 대응하는지는 공식적으로 설명되어 있지 않습니다.

모델 타임라인

다음 표는 x.ai/news와 docs.x.ai의 공개 정보를 정리한 것입니다. 날짜는 공식 페이지를 기준으로 합니다.

공식이 자사 모델에 내린 평가(“most intelligent”, “most powerful”)는 제조사의 자기 설명이므로 이 가이드는 별도로 비교하지 않습니다.

Grok 4.5, 4.6, 4.7의 위치

핵심은 Grok 4.7 공지 원문이 “available today in Cursor and Grok Build … Grok API, third-party coding harnesses”라고 쓰고 있을 뿐 grok.com은 언급하지 않는다는 점입니다. 그 밖의 단편적인 단서들로는 결론을 맞출 수 없습니다.

• x.ai/grok/business의 모델 항목에 Grok 4.7이 나열되어 있습니다(Business 요금제).
• x.ai/pricing은 Premium을 “Latest Grok models”라고 적었습니다.
• 소비자 대화의 기본 모델이 4.5인지 4.7인지는 공식 페이지에 직접 쓰여 있지 않습니다.

따라서 이 가이드는 “Grok 4.7이 grok.com에 들어왔다”고도, “들어오지 않았다”고도 쓰지 않습니다. 확인하려면 로그인한 계정에서 모드 메뉴를 보거나, x.ai/news와 docs.x.ai/developers/release-notes에서 새 공지가 있는지 확인하세요.

Grok 5는 공식 news와 docs 어디에도 공지가 없으며, 이 가이드는 소문으로 도는 출시일을 다루지 않습니다.

예전 이름과 사라진 기능

2025년에 흔히 쓰이던 이름은 조회 기준일의 공식 현행 페이지에서 다르게 처리되어 있습니다.

인터넷 글이 아직도 DeepSearch나 Think를 누르라고 가르치면 자신의 인터페이스와 대조해 보세요. 보이지 않으면 없는 것입니다. 오래된 튜토리얼에 속지 마세요.

API 모델 간단 정리

Grok의 API 모델과 앱의 모드는 서로 독립된 두 체계이며 과금도 따로입니다(요금제에 포함된 것은 앱 사용량이고 API는 요율에 따라 별도 청구). 아래 표는 각 모델의 기본 정보만 나열합니다. 전체 호출 방법, 가격, rate limit, 종료 대응표는 뒤의 API 장에 있습니다. 가격 단위는 USD/100만 token이며, 입력 token이 200k 이하인 표준 가격입니다.

보충 사항은 다음과 같습니다.

• prompt가 200k token 이상이면 요청 전체에 더 높은 단가가 적용됩니다.
• 공식 설명에 따르면 Grok 4.7 Fast(같은 모델, 2배 속도, 2배 가격)는 Cursor와 Grok Build에만 있고 공개 API에는 없습니다.
• 2026-05-15부터 grok-4-1-fast-*, grok-4-fast-*, grok-4-0709, grok-3 등 오래된 slug는 종료되었으며, 요청은 자동으로 grok-4.3으로 리디렉션되어 그 가격으로 청구됩니다.
• 이미지, 영상, 음성에는 grok-imagine-image-2.0, grok-imagine-video-1.5, grok-voice-3.0 등의 모델이 따로 있으며, 자세한 내용은 API 장에서 다룹니다.

자료 출처: Grok 4.7, Grok 4.6, Grok 4.5, Grok 4.5 everywhere, Grok 4.1, Grok 4, Grok 3, Grok Voice 3.0, Grok Skills, Grok Automations, x.ai/grok, x.ai/pricing, Grok Business, Grok FAQ, Models(API), Release notes, May 15 retirement, Grok on the App Store (2026-11-06 조회)

일상 대화: 검색, 파일, 음성, 개인화

이 장은 grok.com과 iOS, Android 앱에서 가장 많이 쓰는 대화 기능을 정리합니다. 조회 기준일은 2026-11-06이며, 공식 페이지에 명시되지 않은 세부 사항은 “공식적으로 공개되지 않았습니다”로 표시하고 오래된 튜토리얼로 메우지 않습니다.

검색과 X 실시간 데이터

Grok이 다른 챗봇과 가장 분명하게 다른 점은 공식적으로 공개 X 게시물 검색을 내장 기능으로 꼽는다는 것입니다. 공식 설명에 따른 동작 방식은 다음과 같습니다.

• Grok은 공개 X 게시물과 실시간 웹 검색을 할지 스스로 판단하고, 그 결과로 답합니다.
• x.ai/grok 제품 페이지에는 답변에 출처 인용이 붙고 같은 주제로 이어서 질문할 수 있다고 쓰여 있습니다.
• 검색 범위는 공개 게시물입니다. X의 설명에 따르면 계정을 “게시물 보호”로 설정하면 게시물이 모델 학습에 쓰이지 않고 다른 사용자의 질문에 대한 답변에서 인용되지도 않습니다.

실제로 쓸 때는 자연어로 Grok에게 X를 조회하라고 요청하면 됩니다. 예를 들면 다음과 같습니다.

App Store의 공식 설명도 이런 용법을 “advanced searches on X”라고 적고 있습니다. 답변은 여전히 틀릴 수 있으며, 공식 소비자 FAQ는 Grok이 때때로 부정확하거나 부적절한 내용을 제공할 수 있다고 분명히 밝히고 사용자가 직접 확인할 것을 권합니다.

입력창의 모드 메뉴

로그인하지 않은 grok.com 입력창에서는 Fast, Auto, Expert, Heavy 네 가지 모드가 보이고, 로그인해야 펼쳐지는 “Premium” 항목이 따로 있습니다. 각 모드가 어떤 모델에 대응하는지, 어떤 요금제에서 쓸 수 있는지는 공식 페이지에 직접 설명이 없습니다. 모델과 모드 장을 보거나 로그인 후 앱에서 확인하세요.

2025년 튜토리얼에는 DeepSearch, DeeperSearch, Think, Big Brain 같은 이름이 자주 나옵니다. 조회 기준일 현재 공식 현행 페이지(x.ai, docs.x.ai, App Store 설명)는 이 이름들을 쓰지 않습니다. App Store 설명은 웹 심층 조사를 “deep research on the web”으로 설명하고, x.ai/grok은 “Deep reasoning”과 “Multi-agent”라고 씁니다. 이 이름들이 바뀐 것인지, 어느 모드에 통합되었는지는 공식적으로 공개되지 않았습니다.

x.ai/grok은 Multi-agent를 여러 agent가 하위 문제를 병렬로 처리하고, 각 agent의 추론을 감사할 수 있으며, 결과를 합쳐 인용이 붙은 하나의 답변으로 만드는 것으로 설명합니다. 이 페이지는 이를 SuperGrok 아래에 두었으며, 새 요금제 체계에서 어느 단계에 대응하는지는 공식적으로 공개되지 않았습니다.

파일 업로드

대화 입력창 옆의 **+**를 눌러 기기의 파일을 선택합니다. 웹 버전에서는 드래그 앤 드롭도 됩니다. 한 메시지에 여러 파일을 첨부할 수 있고, Grok은 처리를 마친 뒤 업로드가 성공했는지 먼저 확인하고 답합니다.

공식 설명에 따르면 플랫폼마다 지원 정도가 조금씩 다르며, 웹 버전의 문서 형식이 보통 가장 완전합니다. 제한은 플랫폼이나 구독 요금제에 따라 약간 조정될 수 있고, 제한을 넘으면 Grok이 오류 메시지를 표시합니다.

할 수 있는 일

공식 설명은 용도를 다섯 가지로 나눕니다. 여러 파일의 종합, 변환(요약, 다시 쓰기, 프레젠테이션을 개요로 바꾸기), 추출(표, 인용문, 메타데이터), 분석(차트, 코드, CSV와 XLSX 데이터 시각화, 오디오와 영상 전사), 텍스트와 이미지를 아우르는 멀티모달 추론입니다.

사용상의 제한과 권장 사항

• PDF가 아닌 파일에 포함된 이미지는 반드시 이미지로 처리되지는 않으며, Grok은 주로 텍스트를 추출합니다.
• 오디오와 영상도 업로드할 수 있지만 전사 품질은 안정적이지 않습니다.
• 100쪽이 넘는 PDF는 Grok이 텍스트와 핵심 이미지에 집중합니다. 질문할 때 실제 쪽수로 범위를 지정하거나 문서를 나누세요.
• 이미지 분석에는 1000 x 1000 픽셀 이상의 이미지를 권장합니다.
• 혼합 업로드(TXT, PDF, PPTX, 이미지, 코드)를 한꺼번에 처리할 수 있습니다. 매우 복잡한 요청은 후속 질문으로 나눌 수 있습니다.

자주 보는 오류

업로드한 파일은 웹 버전의 grok.com/files에서 관리하고 삭제할 수 있습니다. 삭제된 대화와 파일은 표준 보존 기간 안에 시스템에서 제거됩니다. 법률, 규정 준수 또는 보안상 보존이 필요한 경우는 예외이며, 자세한 내용은 개인정보와 데이터 장을 참고하세요.

음성 모드

음성에 대해 공식 설명에서 확인할 수 있는 점은 다음과 같습니다.

• App Store 설명에는 Grok Voice Mode가 있습니다. Grok과 자연스러운 음성으로 대화하고 실시간으로 답을 받으며, 상호작용 방식을 개인화하고 다양한 대화 스타일을 고를 수 있습니다. 같은 설명에는 음성만으로 이미지를 생성할 수도 있다고 나옵니다.
• x.ai/grok은 음성을 “sub-second latency”의 주고받는 대화로 씁니다.
• docs.x.ai의 Grok 개요는 음성을 Grok의 기능(hands-free) 중 하나로 나열하며, 플랫폼별 설명은 없습니다.
• 2026-07-15에 공식적으로 플래그십 음성 21개가 추가되고 기존 다섯 음성의 자연스러움이 개선되었다고 발표했습니다. 이 공지는 Grok Voice 제품 라인에 속하며, 소비자용 앱의 음성 메뉴가 이와 동기화되어 있는지는 공식적으로 공개되지 않았습니다.
• Grok Voice 3.0(2026-10-14)은 음성 모델로, 공식 설명에 따르면 Grok Bot의 음성 모드와 Tesla 차량 내 Grok을 구동합니다. 소비자용 앱의 음성이 지금 어떤 버전의 모델로 동작하는지는 공식적으로 공개되지 않았습니다.

언어에 관해서는 공식 수치가 두 곳에서 일치하지 않습니다. App Store는 영어와 38개 언어, x.ai/grok은 30여 개 언어라고 씁니다. 번체 중국어 음성의 지원 세부 사항은 공식적으로 공개되지 않았으므로 필요하면 앱에서 직접 시험해 보세요.

X 내부에서 Grok 음성을 쓸 때 X의 설명에 따르면 음성 입력의 전사 또는 번역 내용이 개인화와 학습을 위해 xAI와 공유될 수 있으며, 스위치 위치는 개인정보와 데이터 장에 있습니다.

사용자 지정 지침, 기억, 개인화

이 부분은 공식적으로 “명확하게 쓰여 있는 것”과 마케팅 페이지에만 나오는 것을 구분해야 합니다.

Custom instructions와 Memory는 제품 페이지에만 나오고 대응하는 설명 문서가 없으므로 이 가이드는 조작 경로를 적지 않습니다. Grok이 특정 형식이나 절차를 항상 따르게 하려면 공식적으로 완전히 설명된 방법은 Skills입니다(다음 장 참고).

Grok Bot의 기억은 별개의 메커니즘입니다. 각 Bot이 선호, 역할, 지난 작업 요약을 따로 보관하며 grok.com의 대화 기억과는 관련이 없습니다.

Projects는 docs.x.ai의 FAQ가 grok.com에 Projects가 있다고만 언급하고(잘못된 도메인 grok.x.ai를 쓰면 이 기능이 없음), 팀 버전 공지가 Projects를 통해 Collection Search를 할 수 있다고 언급합니다. 자세한 사용법과 요금제 제한은 공식적으로 공개되지 않았습니다.

대화 기록과 공유

• 기록 보기: iOS는 왼쪽 위 프로필 사진을 눌러 대화 기록으로 들어갑니다. grok.com은 오른쪽 위의 기록 아이콘(세 줄과 돋보기)을 누릅니다.
• 대화 공유: 웹 버전에서 Share를 누르거나 대화 아래의 공유 아이콘을 누르면 공개 링크가 만들어집니다. 공식 안내에 따르면 링크를 소셜 플랫폼에 올리면 검색 엔진에 색인될 수 있습니다.
• 공유 철회: grok.com/share-links에서 링크 옆의 Remove를 누릅니다.
• 팀 버전: Grok Business의 팀 workspace에서는 공유 링크를 권한이 있는 구성원만 열 수 있습니다.
• 다른 AI에서 대화 이전: App Store 설명에는 “Easily transfer your conversations and context to Grok”이라고 쓰여 있습니다. 이전 메커니즘과 지원하는 출처는 공식적으로 공개되지 않았습니다.

사용량을 다 쓴 뒤

유료 사용자는 하나의 주간 사용량 풀을 공유하며 Chat도 여기서 차감됩니다. 다 쓰면 유료 기능은 일시 중지되지만 무료 등급의 Chat과 Voice 한도는 계속 쓸 수 있고, 한도는 독립적으로 계산되어 각자 초기화됩니다. 요금제와 사용량 규칙은 요금제와 가격 장을 참고하세요.

Grok Imagine: 이미지와 영상 생성

Grok Imagine은 Grok의 이미지·영상 생성 기능입니다. 진입 경로는 세 가지로, grok.com/imagine, iOS 앱, Android 앱이 있습니다. 일반 대화에서 Grok에게 그림을 그리거나 영상을 만들어 달라고 요청하고 이어지는 프롬프트로 수정할 수도 있습니다. 공식 제품 페이지(x.ai/grok)는 텍스트-이미지와 텍스트-영상이 같은 대화 스레드에 있고, 생성한 뒤에 후속 질문으로 계속 편집할 수 있다고 설명합니다.

조회 기준일은 2026-11-06입니다. 영상의 해상도와 길이는 공식 페이지끼리 일치하지 않으므로 이 장은 각 페이지의 설명을 나란히 제시합니다.

이미지: Imagine Image 2.0

2026-08-07, 공식적으로 Imagine Image 2.0이 grok.com/imagine과 iOS, Android 앱의 Quality Mode가 되었다고 발표했습니다. 공식적인 위치 설정은 “업무에 바로 쓸 수 있는 이미지를 만든다”이며, 핵심은 다음과 같습니다.

해상도에 대해 x.ai/grok 제품 페이지는 이미지를 최대 2K까지 지원한다고 씁니다.

App Store 설명에는 자주 쓰는 편집도 몇 가지 나옵니다. 객체 제거, 배경 교체, 예술 스타일 적용, 사진을 움직이는 영상으로 변환, 음성 지시만으로 이미지 생성입니다.

시작하는 방법

grok.com 첫 화면 입력창 아래에 “Create an image” 같은 바로가기가 있어 누르면 이미지 생성 대화를 시작할 수 있습니다. grok.com/imagine으로 바로 들어가 Quality Mode와 템플릿을 쓸 수도 있습니다. 생성한 뒤에는 후속 프롬프트로 고칠 부분을 설명하거나 magic wand로 영역을 지정하면 되고, 프롬프트 전체를 다시 쓸 필요가 없습니다.

API 쪽 이미지 생성

개발자가 코드로 이미지를 생성하려면 xAI API의 이미지 엔드포인트에 대응하는 모델은 grok-imagine-image-2.0입니다. 공식 문서의 사양은 다음과 같습니다. n은 1에서 10까지 설정할 수 있고, 반환 기본값은 임시 URL이므로 빨리 내려받아야 하며, 편집에는 원본 이미지를 최대 5장까지 넣을 수 있고, 21:9와 5:2 비율도 추가로 제공됩니다. 다음은 docs.x.ai 이미지 생성 페이지의 공식 예시입니다.

curl -X POST 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"
  }'

템플릿

Image 2.0은 자주 쓰는 이미지 작업 흐름을 기성 출발점으로 묶은 템플릿 모음도 함께 내놓았으며, 사용자는 소재만 제공하면 됩니다. 공식 공지에 나열된 템플릿은 다음과 같습니다(이름은 공식 원문).

공식 공지는 “하나의 세계, 여러 장의 이미지” 사용법도 보여 줍니다. 캐릭터, 장면, 소품을 각각 생성하되 같은 스타일을 유지한 뒤, 이를 영상의 참조 소재로 쓰는 것입니다.

영상: Imagine Video 1.5

영상 모델의 타임라인은 다음과 같습니다.

• 2026-06: Imagine Video 1.5가 발표되었으며, 공식 설명은 더 나은 움직임, 물리, 오디오입니다.
• 2026-07-31: 텍스트, 이미지, 음성 참조가 추가되었고, 텍스트 프롬프트만으로 영상을 생성하는 기능(text-to-video)과 네이티브 1080p를 지원합니다.

7월 말 업데이트의 핵심은 다음과 같습니다.

이미지 참조와 음성 참조는 처음에 미국에서 SuperGrok Heavy와 SuperGrok Plus에만 개방되었고, 공식 설명에 따르면 며칠 안에 모든 요금제로 확대되었습니다. App Store 설명에도 영상에 소리를 넣을 수 있다고 나와 있습니다.

해상도와 길이: 공식 페이지 간 내용이 일치하지 않습니다

여러 자료를 합쳐 보면, 요금제마다 영상 상한이 다르다고 해석하는 것이 타당하지만 공식적으로 요금제별 480p, 720p, 1080p와 길이의 대조표는 나열되어 있지 않습니다. 실제로 고를 수 있는 해상도와 초 수는 자신의 계정에서 앱에 표시되는 옵션을 기준으로 하세요. 이 가이드는 요금제별 숫자를 고정해서 쓰지 않습니다.

모델 자체의 능력 범위를 알 수 있도록 API 문서의 사양을 비교용으로 덧붙입니다(앱의 제한과 같지 않습니다).

사용량

Imagine은 Chat, Voice, Build, Bot과 함께 유료 요금제의 주간 사용량 풀을 공유합니다. 공식 설명에 따르면 제품마다 소모량이 다릅니다. 채팅 메시지 하나는 연산을 거의 쓰지 않지만 고품질 영상 생성은 훨씬 많이 씁니다. Settings의 Usage에서 제품별 비중을 볼 수 있습니다. 사용량을 다 쓰면 유료 기능은 일시 중지되고 무료 등급의 Chat과 Voice 한도에는 영향이 없습니다. Imagine의 무료 한도는 공식적으로 “제한적”이라고만 쓰여 있고 숫자는 공개되지 않았습니다.

워터마크와 사용 규칙

워터마크

• 생성된 이미지와 영상에는 모두 AI가 생성한 콘텐츠임을 표시하는 Grok 워터마크가 붙습니다.
• 공식적으로 워터마크를 끄는 설정은 없다고 분명히 밝힙니다.
• 공식 설명은 일부 관할 지역에서는 법적으로 AI 생성 콘텐츠의 표시를 요구한다고도 지적합니다.
• 이용 약관(Terms)에는 사용자가 AI 생성 공시 표시를 요구받거나 SpaceXSI가 자동으로 추가할 수 있다고 명시되어 있습니다.
• Acceptable Use Policy는 “내장된 출처 메타데이터나 워터마크를 제거, 변경 또는 우회하는 행위”를 금지합니다. 워터마크를 제거하거나 가리는 것은 위반이며 계정이 정지될 수 있습니다.

결과물에 대한 권리

공식 Consumer FAQ의 설명은 사용자가 입력과 출력(생성된 이미지 포함)을 소유하며 상업적 용도를 포함해 필요에 따라 사용할 수 있다는 것입니다. 공식적으로는 동시에 브랜드 가이드라인(Brand Guidelines)에 따라 작품이 Grok으로 생성되었음을 표시하라고 요구합니다. 상업적으로 사용하기 전에 약관 원문을 직접 읽으세요.

콘텐츠 규칙

Acceptable Use Policy 중 이미지와 영상에 직접 관련된 금지 사항은 다음과 같습니다.

• 실존 인물을 “탈의”시키거나 나체로 만드는 것, 또는 실존 인물의 이미지나 초상을 바꿔 친밀하거나 성적인 상황으로 표현하는 것.
• 실존 인물의 초상을 외설적으로 묘사하는 것.
• 기만적으로 실존 인물을 사칭하는 것.
• 명예를 훼손하거나 사실이 아닌 방식으로 누군가를 묘사하는 것.
• 아동을 성적으로 대상화하거나 착취하는 것. 공식적으로 아동 성 착취가 의심되는 콘텐츠는 NCMEC에 신고한다고 밝힙니다.

호주에서는 이용 약관에 별도의 전용 규정이 있습니다. 아동 성 착취, 테러 행위 선동, 범죄나 폭력 선동, 마약 관련 범죄 선동, 특정 성적 기호(페티시) 소재의 콘텐츠를 업로드하거나 생성하려고 시도해서는 안 됩니다.

위반하면 계정이 정지되거나 종료될 수 있고 콘텐츠가 삭제될 수도 있습니다. 위반 콘텐츠를 발견하면 Grok 안에서 ”⋯“를 누르고 Report Issue를 선택하거나 [email protected]로 메일을 보내세요. 성인 콘텐츠의 표시 설정과 연령 제한은 개인정보와 데이터 장을 참고하세요.

워크플로와 Grok Bot

2026년 5월부터 8월까지 Grok에는 Connectors, Skills, Automations, Build, 그리고 독립된 Grok Bot이 차례로 추가되었습니다. 이 기능들은 이름이 비슷하지만 서로 다른 두 제품에 속합니다. 앞의 네 가지는 grok.com과 앱 안의 기능이고, Grok Bot은 별도의 앱입니다. 조회 기준일은 2026-11-06입니다.

Connectors(사용자 지정 MCP 포함)

Connectors를 쓰면 Grok이 대화 중에 외부 도구와 데이터에 직접 접근합니다. 메일을 검색하고, 클라우드 파일을 탐색하고, 캘린더를 조회하면서 복사해서 붙여넣기를 오갈 필요가 없습니다.

세 가지 커넥터

docs.x.ai는 커넥터를 세 종류로 나눕니다.

• 내장 커넥터: SpaceXSI가 관리하며 OAuth로 한 번 로그인하면 됩니다.
• 커넥터 디렉터리: 미리 설정된 서드파티 서비스이며 마찬가지로 로그인만 하면 됩니다. 전체 목록은 grok.com/connectors에 있습니다.
• 사용자 지정 MCP 커넥터: 직접 운영하는 Model Context Protocol 서버에 연결합니다.

2026-05-06 출시 공지에 나열된 항목은 조금 다릅니다. SharePoint, Outlook, OneDrive, Google Workspace, Notion, GitHub, Linear, 그리고 사용자 지정 MCP입니다. Notion, GitHub, Linear는 현행 docs의 내장 표에 나오지 않으며 디렉터리에 속하는지는 공식적으로 항목별로 설명하지 않았습니다. grok.com/connectors에서 실제로 보이는 목록을 기준으로 하세요.

추가하는 방법

• 웹: grok.com/connectors에서 New Connector를 누르고 서비스를 선택해 OAuth를 완료합니다. 대화 입력창에서 +를 누르고 Connectors를 선택한 뒤 Add connector를 눌러도 됩니다.
• iOS, Android: Settings에서 Connectors를 선택합니다.
• 공식 설명에 따르면 Grok은 필요한 권한만 요청하며, 연결한 뒤 질문이 해당 서비스와 관련되면 Grok이 알아서 해당 도구를 사용합니다.
• SharePoint를 예로 들면, 공지는 기본적으로 검색과 읽기가 가능하고 쓰기 권한을 켜야 문서, 목록, 페이지를 만들고 수정할 수 있다고 설명합니다.
• 개인정보 처리방침에는 Google OAuth로 연결한 Google 콘텐츠가 SpaceXSI의 AI 학습에 사용되지 않는다고 명시되어 있습니다.

사용자 지정 MCP

grok.com/connectors에서 New Connector를 누르고 Custom을 선택한 뒤 MCP 서버 주소를 입력하고 인증을 완료하면 Grok이 서버가 공개한 도구를 자동으로 읽습니다. 특히 유의할 조건이 하나 있습니다. 서버가 공용 인터넷에서 접속 가능해야 합니다. localhost, 127.0.0.1, 10.x.x.x, 172.16.x.x, 192.168.x.x 같은 사설 주소는 거부됩니다. 로컬에서 실행 중인 서버는 터널링 서비스를 통해 외부에 노출해야 합니다(docs.x.ai의 Custom MCP Tunneling 페이지에 설명이 있습니다).

Grok Business와 Enterprise

팀 버전은 먼저 관리자가 console.x.ai의 Grok Business에서 Connectors를 선택하고, 디렉터리에서 Add Connector로 추가하거나 Other로 MCP 주소를 입력해야 구성원이 grok.com/connectors에서 자신의 계정을 연결할 수 있습니다. 추가와 제거에는 Team Read-Write 권한이 필요합니다. 관리자가 커넥터를 제거하면 구성원은 더 이상 쓸 수 없고, 해당 커넥터와 관련된 인덱스 데이터가 제거될 수 있습니다.

API 쪽 MCP

개발자가 API에서 MCP를 쓰려면 xAI API의 Remote MCP 도구가 있으며, xAI 서버가 대신 MCP 서버에 연결합니다. Streamable HTTP와 SSE만 지원합니다. 다음 예시는 docs.x.ai의 Remote MCP 페이지에서 가져온 것입니다.

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What can you do with https://github.com/xai-org/xai-sdk-python?"
    }
  ],
  "tools": [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki"
    }
  ]
}'

Skills

Skills는 “Grok에게 한 번 가르치면 이후 모든 대화에서 기억하는” 메커니즘이며 grok.com, iOS, Android에서 모두 쓸 수 있습니다. 공식 공지에 따르면 모든 계정에는 설정 없이 xAI가 제공하는 내장 skill이 기본으로 있습니다.

• 사용자 지정 skill을 만드는 방법은 세 가지입니다. 대화에서 설명하기, 파일 업로드, 처음부터 작성하기. 어떤 일을 마친 뒤 Grok에게 방금 익힌 절차를 skill로 저장하라고 시킬 수도 있습니다.
• 사용자가 만든 버전이 내장 버전보다 우선하므로 그대로 덮어쓸 수 있습니다.
• 공지에 따르면 Grok은 바로 공유할 수 있는 Word, PowerPoint, Excel, PDF 파일을 생성할 수 있고, 업로드한 기존 파일을 재구성할 수도 있습니다.
• 공지에는 Skills가 출시될 때 Grok 4.3에서 동작했다고 명시되어 있습니다.

사용자 지정 skill의 공유 방식과 팀 관리에 대해서는 공식 공지가 “공유할 수 있다”고만 언급하며 세부 사항은 공개되지 않았습니다.

Automations

Automations는 Grok이 스스로 실행하는 작업입니다. 한 번 설명하고 실행 시점을 정하면 Grok이 끝낸 뒤 보고합니다. 진입 경로는 grok.com/automations이며 iOS와 Android 앱 안에도 있습니다.

대화 안에서 “매일 아침 뉴스를 찾아서 가격과 관련된 것을 표시해 줘”라고 말하면 Grok이 만들어 줍니다. 예약은 모든 사람에게 개방되어 있고, 메일 트리거는 공지가 발표될 때 “included with SuperGrok”이라고 쓰여 있었습니다. 새 요금제(The X Subscription)에서 어느 단계에 대응하는지는 공식적으로 공개되지 않았습니다.

Build

Build를 쓰면 대화 안에서 웹사이트, 앱, 게임 또는 대시보드를 설명하고, Grok이 대화 안에서 즉시 동작하는 버전을 만들며, 이후에도 계속 수정할 수 있습니다.

• 요금제: 2026-07-28에 Early Beta 형태로 SuperGrok Heavy에만 개방되었고, 2026-08-19부터 모든 요금제, 웹과 모바일(iOS, Android)에서 사용할 수 있습니다.
• 게시: 게시된 앱마다 자체 *.grok.me 주소가 있습니다. 접근 권한은 “나만”, “링크를 아는 사람”, “공개” 중에서 고를 수 있고, 자신의 도메인을 연결할 수도 있습니다.
• 기타 기능: Remix(다른 사람이 게시한 앱을 복사해 수정하게 함), GitHub로 내보내기, Secrets(서드파티 서비스의 키를 앱 코드 밖에 저장), Connectors로 업무 데이터를 필터링 가능한 실시간 대시보드로 만들기.
• Grok을 호출하는 앱: 단일 앱에 SpaceXSI APIs를 켜면 앱이 직접 Grok을 호출해 채팅, 이미지, 음성을 쓸 수 있으며 키를 만들거나 붙여넣을 필요가 없습니다. 권한은 앱 단위이고 언제든 철회할 수 있습니다.
• 유의: docs.x.ai는 grok.com의 Build가 대화와 build session을 보존하며(세션을 넘나드는 앱 게시를 위해) Private Chat을 제공하지 않는다고 설명합니다.

터미널의 Grok Build CLI와 혼동하지 마세요. CLI는 별도의 coding agent이며 설치와 사용량은 따로 설명되어 있습니다. Grok Studio는 지원이 종료되었고 공식적으로는 Grok Build를 쓰라고 안내합니다.

Microsoft 365와 Google Workspace add-in

공식 Grok 4.5 소비자용 공지에도 Grok이 Word, Excel, PowerPoint, Outlook 안에서 바로 동작한다는 내용이 있습니다. 설치 방법과 필요한 요금제에 대해서는 공식 공지 목록에 위의 요약만 있고 더 자세한 내용은 공개되지 않았습니다.

Grok Bot

무엇인가요

Grok Bot은 “자신의 컴퓨터를 가진 AI 팀원”입니다. 공식 설명에 따르면 각 Bot은 (브라우저, 파일 시스템, 터미널이 있는) 영속적인 클라우드 컴퓨터에서 일하며, 사용자는 메시지로 작업을 맡기고, Bot은 실제 도구에서 완료하며, 승인이 필요할 때만 사용자에게 돌아옵니다.

• 앱이나 컴퓨터를 꺼도 클라우드의 작업은 계속됩니다.
• 여러 Bot을 동시에 둘 수 있고, 서로 메시지를 주고받으며 맥락을 공유하고, 그룹 채팅에 넣을 수도 있습니다.
• 사용자가 다음에 어떤 일을 할 때 Bot에게 옆에서 지켜보게 하고, 그 절차를 반복 실행 가능한 routine으로 저장하게 할 수 있습니다.
• 각 Bot은 선호, 역할, 지난 작업 요약을 따로 보관합니다. 사용자의 모든 Bot은 같은 클라우드 컴퓨터를 공유하며, 공식적으로 서로 다른 Bot을 보안 경계로 보지 말라고 경고합니다.
• Bot이 웹사이트에 로그인할 때 비밀번호는 Vault 또는 Secure Form을 거치므로 Bot 자신은 비밀번호를 볼 수 없습니다. SSO, passkey, CAPTCHA처럼 사람만 처리할 수 있는 단계를 만나면 컴퓨터를 사용자에게 돌려줍니다.

grok.com과의 차이

docs.x.ai의 자주 묻는 질문에는 Grok Bot은 grok.com이나 Grok 모바일 앱과 같은 것이 아니다라고 직접 쓰여 있으며, Grok 앱에서 보는 유료 벽이나 “Weekly SuperGrok Limit”도 Grok Bot과 관련이 없습니다.

어떤 요금제에 포함되나요

새 요금제(The X Subscription, 2026-10-12부터 신규 고객 기본)

• Premium, Super, Ultra에는 Grok Bot이 포함되며 개인과 팀 시트가 같습니다.
• Plus와 Free에는 포함되지 않습니다.
• 공식 문서에 따르면 Bot 사용량은 해당 시트의 주간 공용 사용량 풀에서 차감되고(Grok, Cursor와 공유), 따로 추가되는 한도가 아닙니다.
• 사용량은 grok.com/dashboard의 Usage에서 확인합니다. 초과하면 선불 크레딧으로 보충합니다.

기존 요금제(계속 사용 가능)

• 2026-08-11 beta 공지가 개방한 대상: SuperGrok, SuperGrok Plus, SuperGrok Heavy, Cursor Pro, Pro+, Ultra, Cursor Teams의 Standard와 Premium. 2026-08-26 공지는 모든 SuperGrok, Cursor Pro, Cursor Teams 요금제에 Grok Bot이 포함된다고 밝혔습니다.
• 두 공지 모두 Grok Bot에 “자체 사용량”이 있으며 Grok과 Cursor의 요금제 사용량과 별도로 계산되어, Bot에게 맡긴 작업이 원래 요금제 사용량을 소모하지 않는다고 썼습니다.
• docs.x.ai의 Grok Bot 자주 묻는 질문에 따르면 기존 요금제에서는 사용량이 Grok이나 X가 아닌 사용자의 Cursor 계정에 기록되며, Weekly usage limit에 도달한 뒤 on-demand를 켜 두었다면 초과분은 Cursor를 통해 청구됩니다.
• SuperGrok 또는 X Premium+ 연결 규칙: 개인용 SuperGrok, SuperGrok Plus, SuperGrok Heavy, X Premium+를 연결할 수 있습니다. SuperGrok Lite와 Grok Enterprise는 연결할 수 없습니다. 연결은 영구적이어서 스스로 해제할 수 없습니다. Cursor 요금제와 SuperGrok은 합산되지 않고 사용량이 더 큰 쪽을 가져옵니다.
• 이후 The X Subscription으로 전환하면 Bot의 사용량은 새 공용 사용량 풀에서 공급되며, 전환은 되돌릴 수 없습니다.

“독립 사용량”과 “공용 풀 차감”은 두 요금제 세대의 서로 다른 규칙이지 문서의 모순이 아닙니다. 구독하기 전에 자신이 어느 쪽에 속하는지 확인하세요.

플랫폼

2026-08-11 공지는 “desktop and iOS”라고 쓰고, 공지 페이지의 다운로드 버튼도 macOS입니다. docs.x.ai 현행 페이지에는 더 많은 지원 플랫폼이 적혀 있습니다. 데스크톱은 macOS, Windows, Linux, 그리고 iOS(iOS 18 이상)와 Android(Android 9 이상)입니다. 공식 페이지 간 내용이 일치하지 않으므로 x.ai/bot과 스토어에서 실제로 보이는 다운로드 옵션을 기준으로 하세요. Enterprise 요금제의 개방 방식은 공식 영업팀에 문의하세요.

승인 메커니즘과 X 연동

• 동작은 기본적으로 Auto Review가 판단하며 대부분의 동작은 스스로 실행합니다. 사용자의 동의가 필요하면 Bot이 대화 안에 승인 카드를 표시하고, 한 번 허용, 항상 허용, 거부 중에서 고를 수 있습니다. 공식적으로는 요청에 경계를 명시할 것을 권장합니다. 예를 들어 메일 발송, 게시, 삭제, 구매는 항상 먼저 물어보라고 적는 식입니다.
• routine이나 다른 Bot이 트리거했고 사용자가 자리에 없을 때의 승인은 약 30분 뒤에 만료됩니다.
• 2026-08-29부터 X 계정을 연결해 Bot이 게시물을 검색하고, 타임라인을 읽고, 멘션을 조회하게 할 수 있습니다. 유료 사용자에게는 시작용 무료 X API 크레딧이 있습니다.
• X 게시물이나 답글에서 @bot을 태그하면 게시물을 주 Bot에게 작업으로 맡길 수 있습니다. 조건은 Grok 계정에 X 계정이 연결되어 있는 것이며, 호주, 영국, EU, 아이슬란드, 리히텐슈타인, 노르웨이의 X 계정은 현재 태그를 지원하지 않습니다.
• X Chat 안에서 Grok Bot과 대화할 때는 Cursor의 개인정보 처리방침이 적용되고, 동시에 X의 개인정보 처리방침도 적용됩니다.

Grok Bot의 개인정보 설정은 별도 체계이며 개인정보와 데이터 장을 참고하세요.

개인정보 및 데이터 제어

이 장은 모든 분이 읽어 두시기를 권합니다. 요점은 세 가지입니다. 개인용 계정의 내용은 기본값으로 모델 학습에 사용될 수 있으므로 직접 설정에서 꺼야 합니다. X 안에서 쓰는 Grok에는 X의 설정이 적용되며 grok.com과는 별개의 체계입니다. 로그인하지 않고 사용할 때의 학습 규정은 공식 문서의 서술이 서로 일치하지 않습니다.

조회일은 2026-11-06입니다. Consumer FAQ 페이지에 표시된 날짜는 2025-05-12이지만 페이지 하단과 브랜드명은 2026년 기준으로 갱신되어 있으므로, 이 가이드는 현행판으로 간주합니다. 다만 일부 문장(예: 음성은 iOS에서만 지원)은 이미 명백히 오래된 내용이라 인용하지 않습니다.

어느 서비스인지 먼저 구분하기

공식 개인정보 처리방침은 SpaceXSI와 X Corp.가 서로 다른 회사라고 분명히 밝히고 있습니다.

Improve the model 끄기

공식 기본 설명은 다음과 같습니다. SpaceXSI는 사용자의 콘텐츠와 상호작용(프롬프트, 검색 및 사용자가 제출한 기타 데이터)과 Grok의 응답을 모델 학습에 사용할 수 있으며, 사용자가 이를 제어할 수 있다고 안내합니다. 끄는 경로는 다음과 같습니다.

주의할 세부 사항은 다음과 같습니다.

• 끈 뒤에는 새로운 대화만 학습에 사용되지 않으며, 이미 생성된 대화에는 영향이 없습니다.
• 꺼 두어도 자발적으로 제공한 피드백(예: 좋아요 또는 싫어요를 누르고 이유를 적은 경우)은 학습에 사용될 수 있습니다.
• 공식 Private Chat은 별도의 경로입니다. Private Chat을 사용한 내용은 학습에 사용되지 않습니다.
• Business 및 Enterprise 고객의 콘텐츠는 모델 개선에 사용하지 않는다고 공식 문서가 명시합니다.

Private Chat

Grok 화면 오른쪽 위에 유령 아이콘이 있으며, 이를 누르면 Private Chat으로 들어갑니다.

• 대화가 기록에 나타나지 않습니다.
• 내용과 상호작용이 모델 학습에 사용되지 않습니다.
• 대화는 30일 이내에 SpaceXSI 시스템에서 삭제됩니다. 공식 문서의 예외는 이미 비식별화되었거나 가명 처리되어 계정과 분리된 데이터, 그리고 안전, 보안 또는 법적 사유로 보존해야 하는 데이터입니다.

두 가지 제한이 있습니다. 공식 문구에 “where available”이 붙어 있어 모든 상황에서 제공되는 것은 아니며, 또 docs.x.ai는 grok.com의 Build가 대화와 build session을 보존하고 Private Chat을 제공하지 않는다고 설명합니다.

로그인하지 않고 사용할 때: 공식 설명이 일치하지 않음

로그인하지 않고도 grok.com에서 대화할 수 있지만, 이때 데이터가 어떻게 처리되는지에 대해 공식 문서의 세 대목이 서로 맞지 않습니다.

세 가지 중 무엇이 우선하는지는 공식 문서에 설명이 없습니다. 비교적 보수적인 방법은 로그인하지 않은 상태에서는 개인정보, 업무 기밀, 고객 데이터를 입력하지 않는 것입니다. 이런 내용을 다뤄야 한다면 먼저 로그인하고 Improve the model을 끄거나 Private Chat을 사용하십시오.

개인화: Personalize Grok using X

Grok은 사용자의 X 데이터와 상호작용을 사용해 답변을 개인화할 수 있습니다. 스위치 위치는 다음과 같습니다.

• Grok app: Settings, Data Controls, Personalize Grok using X
• grok.com: Settings, Data, Personalize Grok using X

X 계정으로 로그인하면, Terms에 따라 SpaceXSI가 X 프로필(생일 포함), 계정 및 위치 정보, 선호도, 게시물 기록, 사용 데이터, 그리고 X 안에서 Grok과 나눈 대화 기록을 가져오는 데 동의한 것으로 명시됩니다. X 계정을 Grok에 연결하는 경로는 grok.com의 Settings, Account, Connect your X Account입니다.

데이터 삭제 및 다운로드

• 삭제를 요청하면 데이터는 최대 30일 안에 SpaceXSI 시스템에서 제거됩니다. 법적, 안전 또는 보안상 보존이 필요한 데이터는 예외입니다.
• 계정을 삭제한 뒤 30일 이내에 다시 로그인하고 확인하면 복구할 수 있습니다.
• 데이터 다운로드의 구체적인 형식과 대기 시간은 공식적으로 공개되지 않았습니다. FAQ에는 Settings의 Data Controls에서 데이터를 다운로드하거나 삭제할 수 있다고만 적혀 있습니다.
• 그 밖의 데이터 권리 요청(열람, 삭제 등)은 x.ai/privacy-portal에서 합니다. 일반 고객 지원은 [email protected], 개인정보 문의는 [email protected]입니다.
• 공식 문서는 사용자의 데이터를 판매하지 않는다고 밝힙니다.

사람의 검토와 데이터 용도

• 공식 설명에 따르면 SpaceXSI는 자동 분류기와 안전 도구로 위반 사항을 모니터링하며, 제한된 권한을 가진 인원이 모델 개선, 보안 사고 및 남용 조사, 법적 의무 이행을 위해 대화를 열람할 수 있습니다.
• 공식 문서는 질문에 개인정보나 민감한 정보를 입력하지 말 것을 권고합니다.
• 이용약관은 입력과 출력의 소유권이 사용자에게 있다고 명시하면서, 동시에 SpaceXSI에 폭넓은 사용 허락을 부여한다고 밝힙니다. 용도는 서비스 제공, 제품과 모델 개선, 법률 및 안전 요건 준수를 포함합니다.
• 사용자가 Grok의 자율 동작(agentic actions, 예: 웹 탐색, 코드 실행, 메시지 전송, 파일 수정)을 사용할 때, 이러한 동작에 대한 책임은 사용자가 진다고 약관에 명시되어 있습니다.

X 안의 Grok: 별도의 설정

X 내비게이션 바에서 Grok 아이콘(x.com/i/grok)을 누르면 적용되는 것은 SpaceXSI가 아니라 X의 개인정보 처리방침입니다. X 도움말 페이지의 요점은 다음과 같습니다.

• X 도움말은 X가 사용자의 공개 X 데이터와 X 안에서 Grok과 나눈 상호작용을, 모델 학습과 파인튜닝을 위해 xAI와 공유할 수 있다고 밝힙니다. 공개 데이터에는 공개 게시물과 그 상호작용, 공개 Spaces, 공개 프로필이 포함됩니다.
• 음성 입력도 포함됩니다. 전사 또는 번역된 내용이 공유될 수 있습니다.
• 학습을 꺼도 Grok은 계속 사용할 수 있습니다. 다만 Grok이 구동하는 X 기능(예: 추천)의 경우, 학습을 꺼도 이미 배포된 모델이 정상적인 사용을 통해 학습하는 것을 막지는 못합니다.
• 마찬가지로 좋아요 또는 싫어요 피드백은 학습에서 빠지도록 설정해도 학습에 사용될 수 있습니다.
• X Chat 안에서 Grok Bot을 쓸 때 학습 제외는 같은 X 설정 페이지에서 처리합니다. Grok Bot의 데이터는 Grok Bot 계정을 삭제할 때까지 보존되며, Grok Bot 설정 안에서 삭제할 수 있습니다.
• 이 X 도움말 페이지에는 날짜가 표시되어 있지 않고 여전히 회사를 xAI라고 부르고 있어 내용이 최신이 아닐 수 있으므로, X 설정 페이지에 실제로 표시되는 내용을 기준으로 삼으십시오.

연령 제한과 콘텐츠 설정

연령

• Grok을 사용하려면 만 13세 이상(또는 거주 국가가 정한 최소 연령)이어야 합니다. 13세에서 17세는 부모 또는 법정 보호자의 동의가 필요하며, 보호자가 서비스 약관에 동의해야 합니다.
• iOS App Store의 연령 등급은 **16+**입니다.
• 공식 문서는 선택한 기능과 입력에 따라 출력에 욕설, 저속한 유머, 성적 상황 또는 폭력이 포함될 수 있다고 분명히 밝힙니다. FAQ는 Grok에 “unhinged” 스타일로 답하라고 요청하면 불쾌하거나 부적절한 응답을 받을 수 있다고 예를 듭니다. 또한 부모가 청소년의 사용을 감독할 때 app 설정의 데이터 제어 옵션을 활용하라고 안내합니다.

성인 콘텐츠 설정

호주 전용 약관에는 SpaceXSI가 age assurance로 호주 사용자가 만 18세 미만인지 판단하며, 만 18세 이상임이 확인되기 전에는 18+ 성인 콘텐츠에 접근하지 못할 수 있다고 명시되어 있습니다. 같은 대목에는 사용자가 Settings > Data Control에서 18+ 성인 콘텐츠가 포함될 수 있는 미디어에 스스로 노출되지 않도록 제한할 수 있다고도 적혀 있습니다. 이 문장은 호주 약관에 나오는 것이며, 다른 지역에서도 같은지는 공식 문서에 설명이 없습니다.

정책상 금지되는 일

Acceptable Use Policy(2026-08-14 시행)가 열거한 금지 사항 중 데이터 및 콘텐츠와 직접 관련된 것은 다음과 같습니다.

• 실존 인물의 옷을 벗기거나 나체로 만드는 것, 실존 인물의 이미지를 친밀하거나 성적인 상황으로 바꾸는 것, 실존 인물의 초상을 외설적으로 묘사하는 것, 실존 인물을 기만적으로 사칭하는 것.
• 아동을 성적 대상화하거나 착취하는 것. 공식 문서는 아동 성착취가 의심되는 콘텐츠를 NCMEC에 신고한다고 밝힙니다.
• 탈옥(jailbreak), 적대적 프롬프트, prompt injection.
• 내장된 출처 메타데이터나 워터마크를 제거하거나 우회하는 것.
• 출력이나 서비스를 이용해 SpaceXSI와 경쟁하는 머신러닝 모델을 개발하는 것.

위반하면 이용이 정지되거나 계정이 종료될 수 있습니다. 신고 방법은 Grok 안에서 ”⋯“를 눌러 Report Issue를 선택하거나 [email protected]로 메일을 보내는 것입니다. 안전 관련 신고 메일은 [email protected]이며, 보안 취약점은 HackerOne을 통해 신고합니다.

Grok Bot과 API의 데이터

• Grok Bot: Cursor 계정 인증과 데이터 설정을 사용하며, 학습 제외는 해당 Cursor 계정과 개인정보 설정에 따릅니다. 클라우드 데이터 저장소가 필요하므로, 예전 Legacy Privacy Mode 계정은 시작하기 전에 Privacy Mode로 전환하라는 요청을 받습니다. 사용자의 모든 Bot은 같은 클라우드 컴퓨터를 공유하므로, 그 위에 둔 것은 모든 Bot이 접근할 수 있습니다.
• xAI API: API의 요청과 응답은 기본적으로 암호화되어 30일간 보관되며(남용 감사용), 이후 자동 삭제됩니다. 공식 문서는 명시적 동의 없이는 API의 입력과 출력으로 모델을 학습하지 않는다고 밝힙니다. 필요하면 Zero Data Retention을 신청할 수 있지만, 상태 유지 대화, Files, Collections, Batch 등의 기능이 비활성화되므로 공식 문서는 대부분의 고객에게 권장하지 않습니다.

API 빠른 시작과 모델 목록

이 장은 xAI API의 계정과 API key부터 첫 요청, 그리고 현재 사용할 수 있는 텍스트 모델, 가격, reasoning effort까지 다룹니다. API와 Grok 챗봇(grok.com, App)은 서로 다른 제품이며 청구도 별도입니다. 가격과 모델 목록은 매달 바뀌며, 이 장의 수치는 2026-11-06에 docs.x.ai를 조회한 결과입니다. 사용 전에 docs.x.ai/developers/models와 docs.x.ai/developers/pricing을 다시 확인하십시오.

API key 발급받기

절차는 docs.x.ai의 Quickstart(developers/quickstart)에 나옵니다.

1. console.x.ai에서 계정을 등록합니다.
2. API를 사용하려면 먼저 충전(load with credits) 해야 합니다.
3. API Keys 페이지에서 key를 생성합니다.
4. key를 환경 변수 XAI_API_KEY에 넣거나 프로젝트 디렉터리의 .env에 적습니다.

export XAI_API_KEY="your_api_key"

출처: docs.x.ai Quickstart, Step 2.

관련된 사실 몇 가지는 docs.x.ai의 Security FAQ(developers/faq/security)에 나옵니다.

• API key가 묶이는 대상은 개인이 아니라 team입니다.
• key가 유출되면 xAI가 GitHub Secret Scanning과 협력합니다. 유출이 감지되면 key를 비활성화하고 이메일로 알려 줍니다. Console에서 key에 대해 Disable key 또는 Delete key를 직접 선택할 수도 있습니다.
• Management API(key, 결제, audit log 관리)는 별도의 management key를 사용하며 base URL은 https://management-api.x.ai입니다. 출처는 developers/management-api-guide입니다.

Base URL과 인증

GET /v1/models는 해당 key로 사용할 수 있는 모델을 나열하며, 가격, 별칭, reasoning effort 지원 여부가 포함됩니다. 이 외에 /v1/language-models, /v1/image-generation-models, /v1/video-generation-models 분류별 엔드포인트도 있습니다.

첫 번째 요청

공식 Quickstart의 예시는 모두 Chat Completions가 아니라 Responses API(/v1/responses)를 사용합니다. 아래 네 가지 방식은 모두 같은 페이지에 나오며, 예시의 모델은 grok-4.7입니다.

curl

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.7",
    "input": "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"
  }'

Python, OpenAI SDK 사용(pip install openai)

from openai import OpenAI

client = OpenAI(
    api_key="<YOUR_XAI_API_KEY_HERE>",
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
)

print(response.output_text)

JavaScript, OpenAI SDK 사용(npm install openai)

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.XAI_API_KEY,
  baseURL: "https://api.x.ai/v1",
});

const response = await client.responses.create({
  model: "grok-4.7",
  input:
    "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
});

console.log(response.output_text);

Python, 공식 xai-sdk 사용(pip install xai-sdk)

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(model="grok-4.7")
chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

print(chat.sample().content)

JavaScript, Vercel AI SDK 사용(npm install ai @ai-sdk/xai zod)

import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";

const { text } = await generateText({
  model: xai.responses("grok-4.7"),
  prompt:
    "Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}",
});

console.log(text);

위 네 가지의 출처는 모두 docs.x.ai Quickstart(developers/quickstart)입니다.

SDK와 OpenAI 호환

• OpenAI SDK: Python과 JavaScript 모두 base_url(JS는 baseURL)을 https://api.x.ai/v1로 바꾸기만 하면 되고, 나머지는 OpenAI의 Responses API 사용법을 따릅니다.
• xai-sdk(Python): 공식 SDK이며 문서는 gRPC를 사용한다고 설명합니다. Collections, Voice, API key 관리 등의 기능을 포괄하고 REST의 Responses API와 섞어 쓸 수 있습니다. PyPI는 조회일에 최신 버전을 1.21.0(2026-10-23 업로드)으로 표시하며, Python 3.10 이상이 필요합니다.
• JavaScript: 공식 문서의 JS 예시는 OpenAI SDK와 Vercel AI SDK(@ai-sdk/xai)만 사용하며, 문서에는 공식 xAI JavaScript SDK에 대한 언급이 없습니다.
• Anthropic SDK 호환 계층: 공식 legacy 엔드포인트 페이지(developers/rest-api-reference/inference/legacy)는 fully deprecated로 표시하며, Responses API 또는 gRPC를 사용하라고 안내합니다.

모델 목록과 가격

아래는 텍스트 및 멀티모달 모델이며, 입력은 텍스트와 이미지, 출력은 텍스트입니다. 가격 단위는 USD / 100만 token이고 조회일은 2026-11-06이며, 출처는 developers/models와 developers/pricing입니다(두 페이지의 수치는 일치합니다).

긴 context 할증: 위 표는 prompt가 200k token 미만일 때의 가격입니다. prompt가 200k 이상이 되면 요청 전체의 모든 token에 높은 가격이 적용되며, 각 모델의 높은 가격은 위 표의 모든 수치의 정확히 2배입니다(예: grok-4.7은 입력 $4.00, 캐시 $1.00, 출력 $12.00).

모델 페이지의 기타 세부 사항은 다음과 같습니다.

• 여덟 개 모델 모두 function calling과 structured outputs를 지원합니다.
• grok-4.7 모델 페이지에는 “No text output limit”이라고 명시되어 있습니다.
• 별칭 규칙: <model>은 최신 안정 버전, <model>-latest는 최신 버전, <model>-<date>는 고정된 버전입니다. 예를 들어 grok-4.20-0309-reasoning은 grok-4.20으로도 쓸 수 있고, grok-build-0.1의 별칭에는 grok-build-latest가 포함됩니다.
• Grok 4.7 Fast(같은 모델, 2배 속도, 2배 가격. 초장문 context는 1.5배)는 Cursor와 Grok Build에서만 제공되며 공개 API에는 없습니다. 출처는 developers/pricing입니다.
• 이미지 입력은 jpg, jpeg, png를 지원하며, 한 장당 상한은 20 MiB이고 장수 제한은 없습니다. presencePenalty, frequencyPenalty, stop은 reasoning 모델에 사용할 수 없으며, 보내면 오류가 반환됩니다.

이미지, 비디오, 음성 모델은 가격이 따로 책정되며 이 장의 범위에 포함되지 않습니다.

Reasoning effort

reasoning_effort는 모델이 답하기 전에 얼마나 힘을 들여 생각할지 제어합니다. 출처: developers/model-capabilities/text/reasoning.

reasoning token은 출력 token과 같은 방식으로 과금되며, 사용량에는 reasoning_tokens로 보고됩니다. 추론 내용은 평문으로 제공되지 않고 암호화된 버전만 제공됩니다.

인터페이스별 표기는 다음과 같습니다. Responses API는 reasoning: {"effort": "high"}, xai-sdk는 reasoning_effort="high", Vercel AI SDK는 providerOptions.xai.reasoningEffort입니다.

공식 reasoning 페이지의 curl 예시는 다음과 같으며, 여기서 -m 3600은 타임아웃을 3600초로 늘린 것입니다. 공식 문서는 연결이 일찍 닫히지 않도록 reasoning 모델에서 이렇게 하라고 권장합니다.

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -m 3600 \
  -d '{
    "model": "grok-4.7",
    "reasoning": {"effort": "high"},
    "input": [
        {
            "role": "system",
            "content": "You are a highly intelligent AI assistant."
        },
        {
            "role": "user",
            "content": "Find all prime numbers p such that p^2 + 2 is also prime. Prove your answer."
        }
    ]
}'

출처: docs.x.ai Reasoning(developers/model-capabilities/text/reasoning).

공식 페이지가 일치하지 않는 부분:

실무에서는 GET /v1/models가 반환하는 capabilities.reasoning_effort를 기준으로 삼거나, 두 페이지가 일치하는 grok-4.7과 grok-4.6의 설정에만 의존하는 것이 좋습니다. grok-4.20-multi-agent의 reasoning.effort는 사고 깊이를 제어하는 것이 아니라 협업하는 agent의 수(4개 또는 16개)를 제어하며, 이 모델은 beta라서 API 인터페이스에 호환성을 깨는 변경이 있을 수 있습니다.

퇴역한 모델

공식 문서에 따르면 2026-05-15 12:00 PT에 아래 slug가 퇴역했습니다. 퇴역 후에도 slug는 호출할 수 있으며 요청은 자동으로 리디렉션되고, 원래 모델의 가격이 아니라 grok-4.3 가격(입력 $1.25, 출력 $2.50 / 100만 token)으로 과금됩니다. 출처: developers/migration/may-15-retirement.

grok-code-fast-1은 모델 페이지에도 grok-build-0.1의 별칭으로 나열되어 있습니다. 공식 문서에는 grok-3-mini, grok-2 시리즈 등 더 오래된 slug의 상태에 대한 언급이 없으며, 현재 모델 페이지에도 이들 모델은 나열되지 않습니다.

인터넷의 많은 튜토리얼이 여전히 grok-3, grok-4, grok-code-fast-1을 사용하지만, 그대로 따라 하면 grok-4.3으로 리디렉션되어 다른 가격으로 과금됩니다. 새 프로젝트에서는 현행 모델을 직접 지정하십시오.

모델 고르는 법

아래는 공식 모델 페이지와 Release Notes를 바탕으로 차이점을 정리한 것이며, 공식 선택 가이드가 아닙니다.

각 모델의 출시 시기는 Release Notes의 월별 제목을 기준으로 다음과 같습니다. grok-4.20은 2026년 3월, grok-build-0.1은 5월, grok-4.5는 7월(같은 달에 유럽 사용자에게도 개방), grok-4.6은 8월, grok-4.7은 9월입니다.

리전과 데이터 보존

글로벌 엔드포인트 https://api.x.ai는 요청이 어느 지역에서 처리되는지 보장하지 않으며, xAI가 용량 때문에 리전을 넘나들며 라우팅할 수 있습니다. 각 모델 페이지의 Regions 열에 제공 지역이 나열되어 있습니다. 예를 들어 grok-4.7과 grok-4.6은 us-east-1, us-west-2, us-central-1이고, grok-4.3은 us-east-1, eu-west-1, us-west-2이지만, 이것이 라우팅 보장은 아닙니다.

처리를 미국으로 한정하려면 https://us.api.x.ai/v1을 사용할 수 있습니다. 이 엔드포인트는 grok-4.7과 grok-4.6만 제공하고, 이미지, 비디오, 음성은 없으며, token 사용량에 10%가 가산됩니다. 또한 공식 문서는 이것이 완전한 데이터 레지던시 보장이 아니라고 분명히 밝히므로, 계약상 요구가 있으면 먼저 [email protected]에 문의하십시오. 출처: developers/advanced-api-usage/regions.

데이터 보존은 Security FAQ에 따르면 기본적으로 모든 API 요청과 응답이 암호화된 형태로 xAI 서버에 30일간 저장되어 남용 감사에 쓰이고 이후 자동 삭제되며, 사용자의 명시적 동의 없이는 xAI가 API의 입력과 출력으로 모델을 학습하지 않습니다. Zero Data Retention(ZDR)은 team 단위로 켜지만 상태 유지형 Responses, Files, Collections, Batch 등의 기능이 비활성화되므로 공식 문서도 대부분의 고객에게 켜라고 권하지 않습니다.

가격 조회일

이 장의 모든 가격의 조회일은 2026-11-06이며 출처는 docs.x.ai의 Models 및 Pricing 페이지입니다. docs.x.ai의 페이지 대부분에는 마지막 업데이트 날짜가 표시되지 않고, Release Notes만 월 단위로 구분되어 있습니다. 2026년 중에 텍스트 모델로 grok-4.20, grok-build-0.1, grok-4.3, grok-4.5, grok-4.6, grok-4.7이 차례로 추가되었으므로, 사용하기 전에 Console의 Models 페이지와 GET /v1/models의 반환값을 기준으로 삼으십시오.

API 사용량 제한과 과금

xAI API의 제한은 team 단위이며, 누적 지출에 따라 Tier 0부터 Tier 4까지 자동으로 나뉩니다. 과금은 선불 크레딧과 월말 청구서 두 가지가 있습니다. 이 장의 수치는 2026-11-06에 조회한 결과이며, 출처는 docs.x.ai의 Rate Limits(developers/rate-limits), Pricing(developers/pricing), Manage Billing(console/billing)입니다.

Rate limit 계산 방식

각 team은 모델마다 두 가지 차원의 상한을 가집니다.

• RPS: 초당 요청 수. 공식 설명에 따르면 초당 상한은 분당 요청 예산에서 도출됩니다(RPM을 48로 나눈 값, 최소 2). 따라서 1분 분량의 요청을 1초 안에 몰아서 보낼 수 없습니다.
• TPM: 분당 token 수.

어느 한 가지라도 초과하면 HTTP 429가 반환됩니다. TPM에 포함되는 것은 prompt token(텍스트, 이미지, 오디오), completion token, reasoning token, 그리고 캐시된 prompt token입니다. 캐시 token은 과금이 더 낮지만 TPM은 그대로 차지합니다.

예전 글에 자주 나오는 RPM 수치는 그대로 쓰지 마십시오. 현행 문서의 단위는 RPS와 TPM입니다.

Tier와 승급 기준

Tier는 2026-01-01부터의 누적 API 지출로 결정되며, 지출이 기준에 도달하면 신청 없이 자동으로 승급됩니다. 계산의 기준은 선불 크레딧 구매 금액 또는 결제된 청구서입니다. 승급한 뒤에는 강등되지 않는다고 공식 문서가 명시합니다.

Tier별 제한

아래 표는 T0, T1, T2, T3, T4의 수치이며 developers/rate-limits에서 가져왔습니다.

음성 엔드포인트는 token이 아니라 RPS와 동시 연결 수(공식 문서에서는 concurrent sessions라고 부름)로 제한합니다.

보충 설명은 다음과 같습니다.

• Tier 제도는 텍스트, embedding, 음성 모델에 적용됩니다. Imagine API(이미지, 비디오)의 상한을 높이려면 [email protected]로 메일을 보내십시오.
• 내 team의 실제 제한은 Console의 Models 페이지에서 확인할 수 있습니다.
• Batch API의 요청은 rate limit에 포함되지 않습니다.
• 비용을 더 쓰지 않고 상한을 높이고 싶거나 Tier 4를 넘는 한도가 필요하면, Console의 Models 페이지에서 조정을 신청할 수 있습니다. 기업 수준의 용량은 [email protected]로 문의하십시오.

선불 크레딧과 월말 청구

공식 Manage Billing 페이지는 두 가지 과금 방식을 안내합니다.

쉽게 놓치는 동작이 몇 가지 있습니다.

• 월말 청구 한도(invoiced billing limit)의 기본값은 $0입니다. 이때는 선불 크레딧만 사용되며, 크레딧을 다 쓰면 API 요청이 즉시 거부됩니다.
• 월말 청구를 개통하면 시스템이 먼저 선불 크레딧을 쓰고 부족한 부분은 월말에 기본 결제 수단에서 결제합니다. 청구 한도에 도달하면 한도를 높이기 전까지 응답이 오지 않습니다.
• 자동 충전(Auto top-up): 서비스 중단을 막기 위해 켜 두기를 공식 문서가 권장하며, 충전이 시작되는 잔액 기준, 1회 충전 금액(최소 $5), 월 충전 총액 상한을 설정할 수 있습니다. 월 상한의 80%를 사용하면 API spend management 카드에 경고가 표시됩니다.
• 현재 선불 크레딧은 Guest Checkout으로만 구매할 수 있으며, 공식 설명으로는 규제 때문입니다. 은행 이체로 구매하면 2~3영업일이 걸리고, 입금이 확인된 뒤에 크레딧이 지급됩니다.
• Billing 페이지에 promo code 입력란이 있으므로, 프로모션 코드가 있으면 여기서 사용할 수 있습니다.

SuperGrok 및 X의 소비자용 구독은 API 크레딧과 별개입니다. 구독을 구매해도 API 한도가 생기지 않으며, 그 반대도 마찬가지입니다.

공식 문서에는 무료 크레딧이 없음

docs.x.ai의 Billing, Pricing, Rate Limits, Quickstart 페이지 어디에도 “무료 크레딧”이나 “데이터 공유를 대가로 한 크레딧”이라는 설명이 없습니다. Quickstart의 첫 단계는 가입한 뒤 먼저 충전하는 것입니다.

인터넷에는 “신규 계정에 크레딧 증정”, “데이터 공유에 동의하면 매월 크레딧 지급” 같은 이야기가 돌았지만, 서드파티 페이지마다 서로 모순되고 xAI 공식 문서에도 나오지 않습니다. 크레딧이 있는지는 서드파티의 정리가 아니라 Console의 Billing 페이지에 실제로 표시되는 내용을 기준으로 삼으십시오.

기타 과금 규칙

Batch API: 텍스트 모델 -20%

Batch API는 비동기 일괄 처리이며, 대부분의 요청은 24시간 이내에 완료됩니다(공식 문서가 보장하지는 않음). 할인은 grok-4.7, grok-4.6, grok-4.5, grok-4.3, 그리고 grok-4.20의 세 모델에 적용되며 입력, 출력, 캐시, reasoning token에 모두 적용됩니다. grok-build-0.1은 Batch를 지원하지 않습니다. 이미지와 비디오도 Batch로 보낼 수 있지만 일반 가격으로 과금됩니다. 출처: developers/pricing, developers/advanced-api-usage/batch-api.

공식 문서에 나열된 제한은 다음과 같습니다. JSONL 업로드 파일 상한 200 MB, 단일 요청 payload 상한 25 MB, team당 초당 최대 2개의 batch 생성, 30초마다 최대 1000회의 add-requests 호출, 10만 건을 넘는 요청이 든 batch는 스로틀링될 수 있음. ZDR(Zero Data Retention)을 켠 team은 Batch를 사용할 수 없습니다.

batch를 만드는 최소 예시는 다음과 같습니다.

curl -X POST https://api.x.ai/v1/batches \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "name": "customer_feedback_analysis"
  }'

출처: docs.x.ai Batch API(developers/advanced-api-usage/batch-api). 이후 요청을 추가하고 결과를 가져오는 방법은 해당 페이지의 Step 2부터 Step 4를 참조하십시오.

Priority Processing: 2배 요율

텍스트 엔드포인트(Responses, Chat Completions)에 service_tier: "priority"를 추가하면 요청이 더 높은 스케줄링 우선순위를 받으며, 요율은 표준 가격의 2배이고 입력, 출력, 캐시, reasoning token 모두에 적용됩니다. 캐시 할인을 먼저 계산한 뒤 2배를 곱합니다. 응답의 service_tier 필드가 실제로 사용된 등급을 알려 주며, 응답이 priority임을 확인한 경우에만 2배로 과금됩니다. 이미지, 비디오, Batch는 지원하지 않습니다.

response = client.responses.create(
    model="grok-4.7",
    input="Explain the Riemann hypothesis in one paragraph.",
    service_tier="priority",
)
print(response.output_text)
print(f"Tier used: {response.service_tier}")

출처: docs.x.ai Priority Processing(developers/advanced-api-usage/priority-processing). 예시의 client는 9장에서 만든 OpenAI SDK client입니다.

위반 수수료: 사용 규정을 위반한 요청도 과금됩니다. Responses API에서 생성 전에 차단된 요청은 건당 $0.05의 위반 수수료가 부과됩니다. 출처: developers/pricing.

미국 리전 엔드포인트: https://us.api.x.ai/v1을 쓰면 token 사용량에 10%(1.1배)가 가산됩니다. 출처: developers/advanced-api-usage/regions.

비용 계산 예시

아래는 공식 가격으로 계산한 산술 예시이며, 실제 금액은 응답의 usage.cost_in_usd_ticks를 기준으로 합니다. grok-4.7에서 prompt가 200k token 미만인 요청을 일괄로 보내고, 입력 token이 총 100만 개(캐시 없음), 출력 token이 10만 개라고 가정합니다.

reasoning token은 출력 가격으로 과금되므로 reasoning effort를 높게 설정할수록 출력 token이 늘어나 실제 비용은 위 표보다 높아집니다. 도구 호출 비용은 별도이며 11장을 참조하십시오.

요청마다 비용 추적하기

모든 응답의 usage.cost_in_usd_ticks가 해당 요청의 실제 비용을 보고하며, 1 USD는 10,000,000,000 ticks와 같고 캐시 할인과 도구 비용이 이미 포함되어 있습니다. 공식 xai-sdk 예시는 다음과 같습니다.

import os
from xai_sdk import Client
from xai_sdk.chat import user

client = Client(api_key=os.getenv("XAI_API_KEY"))

chat = client.chat.create(
    model="grok-4.7",
    messages=[user("Say hello")],
)
response = chat.sample()

# Convenience property — ticks converted to dollars.
print(f"Cost: ${response.cost_usd:.6f}")

# Raw ticks for integer-precision accounting.
print(f"Cost (ticks): {response.usage.cost_in_usd_ticks}")

출처: docs.x.ai Cost Tracking(developers/cost-tracking).

Prompt caching은 자동으로 이루어집니다. 공식 문서는 Responses API에서 prompt_cache_key를 설정하라고 권장하며(Chat Completions에서는 x-grok-conv-id header), 같은 대화가 같은 머신에 배정되도록 하기 위해서입니다. 캐시된 token 수는 usage.input_tokens_details.cached_tokens에서 읽을 수 있습니다. 출처: developers/advanced-api-usage/prompt-caching.

429를 만났을 때 처리 방법

공식 방법은 간단합니다. 지수 백오프(exponential backoff) 를 구현하는 것입니다. 예시에서는 실패할 때마다 1, 2, 4, 8초 순으로 기다렸다가 재시도하며(2의 attempt 제곱), 재시도 한도에 도달하면 오류를 던집니다. xai-sdk는 gRPC를 사용하며 대응하는 오류 코드는 RESOURCE_EXHAUSTED입니다.

공식 Rate Limits 페이지의 예시는 다음과 같습니다. 이 예시는 legacy인 chat.completions를 호출하지만, client.responses.create로 바꿔도 백오프 로직은 완전히 같습니다.

import os
import time
from openai import OpenAI, RateLimitError

client = OpenAI(base_url="https://api.x.ai/v1", api_key=os.getenv("XAI_API_KEY"))

def request_with_backoff(messages, max_retries=5):
    for attempt in range(max_retries):
        try:
            return client.chat.completions.create(
                model="grok-4.7",
                messages=messages,
            )
        except RateLimitError:
            if attempt == max_retries - 1:
                raise
            wait = 2 ** attempt
            time.sleep(wait)

출처: docs.x.ai Rate Limits(developers/rate-limits).

공식 Debugging 페이지(developers/debugging)가 429에 대해 권하는 것은 요청 빈도를 낮추거나 Console에서 상한을 높이는 것입니다. 429를 처리할 때는 공식 문서에 따라 다음을 할 수 있습니다.

1. 먼저 Models 페이지에서 내 Tier와 해당 모델의 RPS, TPM을 확인합니다.
2. 캐시 token도 TPM에 포함된다는 점을 기억하십시오. 긴 prompt는 캐시에 적중하더라도 한도를 차지합니다.
3. 즉시 결과가 필요하지 않은 작업량은 Batch API로 돌리십시오. Batch는 rate limit에 포함되지 않습니다.
4. 더 높은 상한이 필요하면 누적 지출로 Tier를 올리거나, Models 페이지에서 조정을 신청하거나, [email protected]에 문의하십시오.

또한 Debugging 페이지의 오류 코드 표에는 400, 401, 403, 404, 405, 415, 422, 429만 나열되어 있고 5xx 항목은 없으며, 전체 오류 body 규격도 없습니다. 서비스 상태는 status.x.ai를 확인하십시오.

텍스트 생성, 구조화 출력, 내장 도구

이 장은 API로 텍스트를 생성할 때의 주요 기능을 설명합니다. Responses API, streaming, reasoning, structured outputs, function calling, 이미지 입력, 그리고 xAI 서버가 대신 실행하는 내장 도구입니다. 예시의 출처는 모두 docs.x.ai의 해당 페이지이며 모델은 일관되게 grok-4.7을 사용합니다. 가격과 제한은 2026-11-06에 조회한 결과입니다.

Responses API와 Chat Completions

공식 문서는 Responses API(/v1/responses)를 권장하며, 기존 Chat Completions(/v1/chat/completions)에는 legacy 표시가 붙어 있습니다. 출처: developers/model-capabilities/text/comparison, developers/model-capabilities/legacy/chat-completions.

파라미터 대응은 다음과 같습니다.

응답 내용의 위치도 다릅니다. Chat Completions는 choices[0].message.content에 있고, Responses API는 output 배열 안에서 타입으로 구분되는 항목에 있으며, SDK의 output_text는 순수 텍스트를 가져오는 편의 속성입니다.

legacy에 대한 공식 문서의 표현은 일치하지 않습니다. comparison 페이지의 표 머리글은 Deprecated라고 쓰고, chat-completions 페이지는 “offered as a legacy endpoint”라고 씁니다. 두 곳의 권고는 같으며 모두 Responses API로 마이그레이션하라는 것입니다.

서버 측 저장: Responses API는 기본적으로 prompt, reasoning, 응답을 서버에 30일간 저장하며, store: false를 보내면 끌 수 있습니다. 저장을 끈 채 reasoning 모델을 쓸 때는 include: ["reasoning.encrypted_content"]로 암호화된 사고 내용을 받아 다음 턴에 그대로 되돌려 보낼 수 있습니다. grok-4.7은 include가 있든 없든 항상 반환합니다.

멀티턴 대화의 공식 예시는 다음과 같습니다. 해당 페이지의 원래 예시는 이미 퇴역한 grok-4를 사용하지만, 여기서는 grok-4.7로 바꿨습니다.

# First request
response = client.responses.create(
    model="grok-4.7",
    input=[{"role": "user", "content": "What is 2+2?"}],
)

# Continue the conversation - no need to resend history
second_response = client.responses.create(
    model="grok-4.7",
    previous_response_id=response.id,
    input=[{"role": "user", "content": "Now multiply that by 10"}],
)

출처: docs.x.ai Comparison with Chat Completions API(developers/model-capabilities/text/comparison).

Streaming

텍스트를 출력하는 모든 모델이 streaming을 지원하며, 이미지 생성 모델은 지원하지 않습니다. "stream": true를 설정하면 서버가 SSE(Server-Sent Events)로 증분 내용을 반환합니다. 공식 문서의 주의 사항: reasoning 모델은 연결이 일찍 닫히지 않도록 요청 타임아웃을 직접 늘릴 것을 권장합니다(공식 예시는 3600초). 출처: developers/model-capabilities/text/streaming.

공식 streaming 페이지의 예시는 Chat Completions를 사용합니다. Responses API의 streaming 방식은 Tools Overview(developers/tools/overview)에 나오며, 내장 도구도 함께 지정합니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input=[
        {"role": "user", "content": "What are the latest updates from xAI?"}
    ],
    tools=[
        {"type": "web_search"},
        {"type": "x_search"},
        {"type": "code_interpreter"},
    ],
    stream=True,
)

for event in response:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)

출처: docs.x.ai Tools Overview. 공식 예시의 prompt 원문은 해당 회사의 최신 동향을 묻는 것이며, 여기서는 더 일반적인 표현으로 바꿨습니다.

구현할 때 주의할 점이 두 가지 있습니다.

• streaming 중에 function call은 하나의 chunk에 통째로 나타나며, 나뉘어 스트리밍되지 않습니다.
• 공식 문서에는 WebSocket 모드(하나의 긴 연결을 쓰며, 공식 측정으로 도구 호출이 많은 agent 루프에서 엔드투엔드 지연이 최대 약 20% 감소하고, ZDR 및 store=false와 호환)와 Context Compaction API(긴 대화의 context를 줄임)도 따로 있으며, 각각 developers/advanced-api-usage/websocket-mode와 developers/advanced-api-usage/context-compaction을 참조하십시오.

Reasoning

reasoning.effort(Responses API)는 low, medium, high(기본값), xhigh 중에서 고를 수 있으며, 모델별 지원 범위와 공식 페이지 사이의 불일치는 9장을 참조하십시오. reasoning token은 출력 가격으로 과금되고, 추론 내용은 암호화된 버전만 제공됩니다.

Structured outputs

structured outputs는 응답이 사용자가 제공한 JSON Schema를 엄격히 따르게 합니다. 출처: developers/model-capabilities/text/structured-outputs.

• Responses API는 text.format을, Chat Completions는 response_format(json_schema, json_object, text)을 사용합니다.
• Pydantic(Python) 또는 Zod(JavaScript)로 schema를 정의할 수 있습니다.
• function calling의 파라미터는 항상 schema를 엄격히 따릅니다(strict가 암묵적으로 true).
• 내장 도구, function calling과 함께 쓸 수 있어서 “먼저 도구로 자료를 조회한 뒤 정해진 형식으로 반환”하는 결과를 얻을 수 있습니다.

지원되는 JSON Schema는 부분집합입니다.

Python에서 Pydantic과 web search를 함께 쓰는 공식 예시입니다.

import os
from openai import OpenAI
from pydantic import BaseModel, Field

class ProofInfo(BaseModel):
    name: str = Field(description="Name of the proof or paper")
    authors: str = Field(description="Authors of the proof")
    year: str = Field(description="Year published")
    summary: str = Field(description="Brief summary of the approach")

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

response = client.responses.parse(
    model="grok-4.7",
    input="Find the latest machine-checked proof of the four color theorem.",
    tools=[
        {"type": "web_search"}
    ],
    text_format=ProofInfo,
)

proof = response.output_parsed
print(f"Name: {proof.name}")
print(f"Authors: {proof.authors}")
print(f"Year: {proof.year}")
print(f"Summary: {proof.summary}")

출처: docs.x.ai Structured Outputs의 Agentic Tools with Structured Output 절. 공식 페이지는 ProofInfo의 정의와 호출을 두 블록으로 나눠 놓았으며, 여기서는 하나로 합쳤습니다.

Function calling

function calling은 모델이 사용자의 프로그램에 사용자 정의 함수를 실행해 달라고 요청하게 합니다. 흐름은 developers/tools/function-calling에 나옵니다.

1. tools에 함수의 name, description, JSON Schema 파라미터를 정의합니다.
2. 모델이 function_call 항목을 반환합니다.
3. 사용자의 프로그램이 함수를 실행하고, function_call_output과 previous_response_id로 결과를 되돌려 보냅니다.
4. 모델이 결과를 바탕으로 최종 응답을 생성합니다.

tool_choice는 auto(기본값), required, none 또는 특정 함수 하나를 지정할 수 있습니다. 병렬 호출은 기본적으로 켜져 있어 모델이 한 응답 안에서 여러 도구 호출을 요청할 수 있으며, 끄려면 parallel_tool_calls: false를 보냅니다. Chat Completions reference에는 함수가 최대 128개라고 적혀 있습니다. function calling은 서버 측 내장 도구와 섞어 쓸 수 있습니다.

공식 예시입니다.

import os
import json
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://api.x.ai/v1",
)

tools = [
    {
        "type": "function",
        "name": "get_temperature",
        "description": "Get current temperature for a location",
        "parameters": {
            "type": "object",
            "properties": {
                "location": {"type": "string", "description": "City name"},
                "unit": {"type": "string", "enum": ["celsius", "fahrenheit"], "default": "fahrenheit"}
            },
            "required": ["location"]
        },
    },
]

response = client.responses.create(
    model="grok-4.7",
    input=[{"role": "user", "content": "What is the temperature in San Francisco?"}],
    tools=tools,
)

# Handle function calls
for item in response.output:
    if item.type == "function_call":
        args = json.loads(item.arguments)
        result = {"location": args["location"], "temperature": 59, "unit": args.get("unit", "fahrenheit")}

        response = client.responses.create(
            model="grok-4.7",
            input=[{"type": "function_call_output", "call_id": item.call_id, "output": json.dumps(result)}],
            tools=tools,
            previous_response_id=response.id,
        )

for item in response.output:
    if item.type == "message":
        print(item.content[0].text)

출처: docs.x.ai Function Calling(developers/tools/function-calling).

이미지 입력

Responses API의 content에 input_image와 input_text를 넣습니다. image_url은 공개 URL이거나 data:image/jpeg;base64,... 형태의 base64일 수 있습니다. jpg, jpeg, png를 지원하고 한 장당 상한은 20 MiB이며 장수에는 상한이 없습니다. 이미지는 token으로 과금됩니다. 출처: developers/model-capabilities/images/understanding.

response = client.responses.create(
    model="grok-4.7",
    input=[
        {
            "role": "user",
            "content": [
                {
                    "type": "input_image",
                    "image_url": image_url,
                    "detail": "high",
                },
                {
                    "type": "input_text",
                    "text": "What's in this image?",
                },
            ],
        },
    ],
)

출처: docs.x.ai Image Understanding. 공식 문서의 주의 사항: 이미지를 보낼 때는 요청과 응답을 서버에 저장하지 않기를 권장하며, 저장하면 실패할 수 있습니다.

내장 도구

내장 도구는 xAI의 서버 측에서 실행됩니다. tools에 사용할 도구를 설정하기만 하면 API가 자동으로 실행하고 결과와 인용 출처를 반환합니다. 공식 처리 흐름은 질문을 분석하고, 도구를 호출할지 바로 답할지 결정하고, 도구를 실행하고, 결과를 정리하는 과정을 정보가 충분해질 때까지 반복한 다음, 인용이 포함된 응답을 반환하는 것입니다. 출처: developers/tools/overview.

내장 도구는 2025-10에 정식 출시(GA)되었습니다. 도구 응답의 citations 속성은 기본적으로 항상 반환되며 agent가 검색 과정에서 마주친 모든 출처 URL을 나열합니다. 이와 별도로 응답 텍스트에 삽입된 inline citations도 있으며 developers/tools/citations를 참조하십시오.

비용 = token 사용량 + 도구 호출 횟수. 모델이 도구를 몇 번 호출할지 스스로 결정하므로 질문이 복잡할수록 비용이 높아집니다. 아래는 developers/pricing의 도구 가격입니다.

보충 설명은 다음과 같습니다.

• X Search는 “가져온 건수” 기준으로 과금합니다. 검색 또는 스레드 조회로 반환되는 게시물 하나하나(상위 게시물과 인용 게시물 포함)가 한 건이며, 사용자 검색으로 반환되는 프로필 하나가 한 건입니다.
• Image Search는 Web Search에 속하며 Web Search 요율로 계산합니다.
• xai-sdk(gRPC)는 code_interpreter와 file_search 별칭을 지원하지 않으므로 code_execution과 collections_search를 써야 합니다.
• 이와 별도로 일반 token 비용도 있습니다. input, reasoning, completion, image, 캐시 token은 모두 해당 요청에 사용된 모델의 가격으로 계산됩니다.

xai-sdk와 Vercel AI SDK는 표기가 다르며, 공식 Tools Overview의 Vercel AI SDK 예시는 다음과 같습니다.

import { xai } from "@ai-sdk/xai";
import { streamText } from "ai";

const { fullStream } = streamText({
  model: xai.responses("grok-4.7"),
  prompt: "What are the latest updates from xAI?",
  tools: {
    web_search: xai.tools.webSearch(),
    x_search: xai.tools.xSearch(),
    code_execution: xai.tools.codeExecution(),
  },
});

for await (const part of fullStream) {
  if (part.type === "text-delta") {
    process.stdout.write(part.text);
  } else if (part.type === "source" && part.sourceType === "url") {
    console.log(`Citation: ${part.url}`);
  }
}

출처: docs.x.ai Tools Overview. 마찬가지로 prompt를 일반적인 표현으로 바꿨습니다.

Web Search

실시간으로 검색하고 웹을 탐색합니다. 사용할 수 있는 파라미터는 allowed_domains(최대 5개), excluded_domains(최대 5개, allowed_domains와 동시에 사용할 수 없음), enable_image_understanding(agent가 검색 과정에서 만난 이미지를 분석하게 함), enable_image_search(결과에 이미지를 삽입할 수 있음)입니다. 출처: developers/tools/web-search.

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What is xAI?"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}'

출처: docs.x.ai Web Search. 원문의 prompt는 회사 이름을 묻는 간단한 질문이며, 여기서는 고쳐 썼습니다.

X Search

X의 게시물, 사용자, 스레드를 검색하며, 키워드 검색(X 고급 검색 연산자 사용 가능), 의미 기반 검색, 사용자 검색, 스레드 조회를 지원합니다. 파라미터에는 allowed_x_handles / excluded_x_handles(각각 최대 20개, Vercel AI SDK는 10개), from_date / to_date(YYYY-MM-DD), enable_image_understanding, enable_video_understanding(기본값 false)이 있습니다. 출처: developers/tools/x-search.

import { xai } from "@ai-sdk/xai";
import { generateText } from "ai";

const { text, sources } = await generateText({
  model: xai.responses("grok-4.7"),
  prompt: "What are people saying about xAI on X?",
  tools: {
    x_search: xai.tools.xSearch(),
  },
});

console.log(text);
console.log("Citations:", sources);

출처: docs.x.ai X Search. 원문 prompt의 회사 이름이 달라서 여기서는 고쳐 썼습니다.

Code Execution

Grok이 Python을 작성해 샌드박스에서 실행하게 하며, 정밀한 계산, 데이터 분석, 검증에 쓰입니다. NumPy, Pandas, Matplotlib, SciPy 같은 일반적인 패키지가 미리 설치되어 있습니다. 샌드박스는 외부 네트워크가 없고, 파일 시스템이 제한되며, 요청 사이에 상태가 유지되지 않고, 큰 데이터셋은 메모리 제한에 걸릴 수 있습니다. 공식 페이지는 구체적인 실행 시간과 메모리 수치를 공개하지 않았습니다. 출처: developers/tools/code-execution.

도구 이름은 인터페이스마다 다릅니다. xAI SDK는 code_execution, Responses API는 code_interpreter, Vercel AI SDK는 xai.tools.codeExecution()입니다.

response = client.responses.create(
    model="grok-4.7",
    input=[
        {
            "role": "user",
            "content": "Calculate the compound interest for $10,000 at 5% annually for 10 years",
        },
    ],
    tools=[
        {
            "type": "code_interpreter",
        },
    ],
)

print(response)

출처: docs.x.ai Code Execution의 Basic Calculations 절이며, client를 만드는 방법은 위의 Responses 예시와 같습니다.

Collections와 Files

둘 다 모델이 사용자 자신의 문서를 읽게 하는 것이지만 용도가 다릅니다. 출처: developers/files, developers/files/collections, developers/pricing.

Files에는 agentic 도구를 지원하는 모델이 필요하며, 공식 문서는 grok-4.20, grok-4.5, grok-4.6, grok-4.7을 나열하고 텍스트, 코드, csv, json, pdf 등의 형식을 지원합니다. ZDR을 켠 team은 Files와 Collections를 사용할 수 없습니다. Collections를 조회하는 도구의 이름은 collections_search(Responses API에서는 file_search로도 쓸 수 있음)이며, 호출 비용은 1000회당 $2.50입니다. collection을 만들고, 업로드하고, 조회하는 전체 흐름은 developers/tools/collections-search를 참조하십시오.

Remote MCP

xAI의 서버가 사용자를 대신해 외부 MCP server에 연결하여 Grok이 그 안의 도구를 쓰게 합니다. 출처: developers/tools/remote-mcp.

OpenAI Responses API의 require_approval과 connector_id 파라미터는 현재 지원되지 않습니다. Remote MCP는 Speech to Speech API에서도 쓸 수 있습니다. 도구 호출 자체에는 별도 요금이 없고 token만 계산됩니다.

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4.7",
  "input": [
    {
      "role": "user",
      "content": "What can you do with https://github.com/xai-org/xai-sdk-python?"
    }
  ],
  "tools": [
    {
        "type": "mcp",
        "server_url": "https://mcp.deepwiki.com/mcp",
        "server_label": "deepwiki"
    }
  ]
}'

출처: docs.x.ai Remote MCP Tools.

Live Search의 현황

2025-05 Release Notes는 Live Search가 API에 출시되었다고 명시하는데, 이는 Chat Completions의 search_parameters 파라미터(mode, sources, from_date, to_date, max_search_results, return_citations)를 가리킵니다. 현재 API reference의 Chat Completions에는 이 파라미터가 여전히 남아 있지만 내비게이션에는 이미 Live Search 페이지가 없으며, 공식 문서가 주로 밀고 있는 것은 위에서 설명한 web_search와 x_search 도구입니다. 공식 문서에 “Live Search는 폐기되었다”고 명확히 적혀 있지는 않으므로, 새 프로젝트에서는 내장 도구를 바로 쓰고 기존의 search_parameters는 legacy 엔드포인트의 파라미터로 간주할 것을 권장합니다. 출처: developers/release-notes, developers/rest-api-reference/inference/chat-completions.

이미지, 비디오, 음성 API

Grok의 미디어 기능은 두 묶음의 API로 나뉩니다. Imagine API는 이미지와 비디오 생성을, Voice API는 실시간 음성 대화(Speech to Speech), 텍스트 음성 변환(TTS), 음성 텍스트 변환(STT)을 담당합니다. 두 묶음 모두 같은 XAI_API_KEY 하나를 쓰지만, 각각 독립된 모델, 엔드포인트, 가격 체계를 가집니다. 이 장의 내용은 2026-11-06의 docs.x.ai 페이지를 기준으로 하며, 모델과 가격은 갱신이 빠르므로 작업하기 전에 공식 페이지와 대조하십시오.

두 가지 전제 조건이 있습니다.

• 미국 리전 엔드포인트(us.api.x.ai)는 이미지, 비디오, 음성을 제공하지 않습니다. 이 세 가지는 글로벌 엔드포인트 https://api.x.ai로만 쓸 수 있으며, 리전 엔드포인트에 대한 설명은 다음 장에 있습니다.
• Zero Data Retention(ZDR)을 켜면 이미지와 비디오를 xAI가 대신 보관할 수 없으므로 업로드할 주소를 직접 마련해야 합니다. 이 장의 “이미지 생성”과 “비디오 생성” 절을 참조하십시오.

Imagine API 개요

출처: docs.x.ai “Imagine Overview”(/developers/model-capabilities/imagine).

이미지 생성

출처: docs.x.ai “Image Generation”과 “Imagine Overview”. 현재 주력 모델은 grok-imagine-image-2.0이며, 이전의 grok-imagine-image(1.0)도 계속 사용할 수 있습니다.

최소한의 요청입니다.

curl -X POST 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"
  }'

자주 쓰는 파라미터입니다.

놓치기 쉬운 동작이 몇 가지 있습니다.

• 반환되는 주소는 일시적이므로 가능한 한 빨리 다운로드하십시오.
• quality가 auto이면 생성에는 low, 편집에는 medium이 사용되며, 실제로 제공된 품질에 따라 과금됩니다.
• 공식 2026-11 공지에 따르면 grok-imagine-image-quality와 grok-imagine-image-pro 두 이름은 퇴역했고, 요청은 자동으로 grok-imagine-image-2.0에 quality: "low"를 붙여 처리하므로 코드를 바꿀 필요가 없습니다.
• 같은 prompt로 여러 버전이 필요할 때 공식 문서는 n을 쓰라고 권장하며, 요청을 반복해서 보내는 것보다 효율적입니다.

이미지 편집

출처: docs.x.ai “Imagine Overview”. 원본 이미지는 공개 주소 또는 base64 data URI일 수 있고 한 번에 최대 5장이며, 피사체 합성, 스타일 변환, 장면 조합에 쓸 수 있습니다.

curl -X POST https://api.x.ai/v1/images/edits \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-image-2.0",
    "prompt": "Render this as a pencil sketch with detailed shading",
    "image": {
      "url": "https://docs.x.ai/assets/api-examples/images/style-realistic.png",
      "type": "image_url"
    }
  }'

비디오 생성

출처: docs.x.ai “Video Generation”. 비디오 요청은 비동기입니다. 먼저 요청을 보내 request_id를 받고, 상태가 done이 될 때까지 폴링합니다. xAI SDK와 Vercel AI SDK는 자동으로 폴링합니다.

요청 모드입니다.

설정 범위: duration은 1에서 15초(기본값 8), resolution은 480p, 720p, 1080p 중에서 고르며 기본값은 480p, 가로세로 비율은 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9, 5:2를 지원하고 기본값은 16:9입니다. 비디오에는 기본적으로 오디오 트랙이 포함되며, generate_audio: false를 보내면 소리 없는 비디오를 받을 수 있습니다.

폴링의 전체 작성법입니다(출처: docs.x.ai “Imagine Overview”).

# Start the video generation request
REQUEST_ID=$(curl -s -X POST https://api.x.ai/v1/videos/generations \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
    "model": "grok-imagine-video-1.5",
    "prompt": "Make the water crash down and slowly pan out the camera",
    "image": {"url": "https://docs.x.ai/assets/api-examples/video/waterfall-still.png"},
    "duration": 12
  }' | jq -r '.request_id')

# Poll until the video is ready
while true; do
  RESULT=$(curl -s https://api.x.ai/v1/videos/$REQUEST_ID \
    -H "Authorization: Bearer $XAI_API_KEY")
  STATUS=$(echo "$RESULT" | jq -r '.status')
  if [ "$STATUS" = "done" ]; then
    echo "$RESULT" | jq -r '.video.url'
    break
  elif [ "$STATUS" = "failed" ] || [ "$STATUS" = "expired" ]; then
    echo "Request $STATUS"; echo "$RESULT" | jq .
    break
  fi
  sleep 5
done

실패했을 때의 error.code입니다(출처: “Video Generation”의 Error Handling).

Imagine의 가격과 제한

출처: docs.x.ai “Pricing”, “Rate Limits”와 2026-11의 마이그레이션 공지.

세 가지를 보충합니다.

• 마이그레이션 공지는 grok-imagine-image-2.0의 low 품질에서 1K는 $0.04, 2K는 $0.06이며, 편집 시에는 입력 이미지 한 장마다 $0.01가 추가된다고 나열합니다. medium 품질의 단가는 공식 페이지에 나열되어 있지 않으므로 가격 페이지와 응답의 usage.cost_in_usd_ticks를 기준으로 삼으십시오.
• 공식 문서는 Imagine 개요에서 “비디오의 길이와 해상도가 모두 비용에 영향을 준다”고 쓰지만, 가격 페이지에는 단일 초당 가격만 나열되어 있습니다. 두 곳의 설명이 완전히 일치하지는 않으므로 실제 비용은 응답의 사용량 필드를 기준으로 삼으십시오.
• Imagine의 Rate limit에는 Tier 자동 승급이 적용되지 않으며, 한도를 높이려면 [email protected]로 메일을 보내야 합니다. 기준값(Tier 0에서 Tier 4, 초당 요청 수): 이미지 모델 6, 12, 25, 50, 100, 비디오 모델 10, 20, 39, 79, 158.

Voice API 개요

출처: docs.x.ai “Voice Overview”.

Speech to Speech: 실시간 음성 agent

출처: docs.x.ai “Speech to Speech”와 “Voice Overview”.

연결 주소는 wss://api.x.ai/v1/realtime?model=grok-voice-latest입니다. grok-voice-latest는 별칭이며 현재 grok-voice-3.0을 가리킵니다. grok-voice-2.0은 deprecated로 표시되었고, API는 같으며 가격도 같습니다.

import asyncio
import json
import os
import websockets

async def voice_agent():
    async with websockets.connect(
        "wss://api.x.ai/v1/realtime?model=grok-voice-latest",
        additional_headers={"Authorization": f"Bearer {os.environ['XAI_API_KEY']}"}
    ) as ws:
        # Configure voice and enable tools
        await ws.send(json.dumps({
            "type": "session.update",
            "session": {
                "voice": "eve",
                "instructions": "You are a helpful customer support agent.",
                "turn_detection": {"type": "server_vad"},
                "tools": [{"type": "web_search"}]
            }
        }))

        # Stream audio and receive responses
        async for message in ws:
            event = json.loads(message)
            if event["type"] == "response.output_audio.delta":
                # Play audio: base64.b64decode(event["delta"])
                pass

asyncio.run(voice_agent())

session.update에서 자주 쓰는 필드입니다.

브라우저와 모바일 클라이언트에는 API key를 넣지 마십시오. 공식 문서는 Ephemeral Tokens를 권장합니다. 사용자의 서버가 POST https://api.x.ai/v1/realtime/client_secrets에서 수명이 짧은 token을 받아 클라이언트에 전달하는 방식입니다(출처: docs.x.ai “Ephemeral Tokens”).

curl --url https://api.x.ai/v1/realtime/client_secrets \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  --data '{
    "expires_after": {
      "seconds": 300
    }
  }'

전화 환경에서는 SIP를 통해 PSTN 또는 PBX의 수신 전화를 session에 연결할 수 있으며, Twilio, WebRTC, iOS 예제 프로젝트도 xai-cookbook에 있습니다. 동시 연결 수는 Tier에 따라 다르며, Tier 0에서 Tier 4까지 순서대로 10, 20, 50, 100, 200개입니다.

Text to Speech

출처: docs.x.ai “Text to Speech”.

curl -X POST https://api.x.ai/v1/tts \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "Welcome to our service. How can I help you today?",
    "voice_id": "eve",
    "language": "en"
  }' \
  --output welcome.mp3

(예시의 문장은 일반적인 문장으로 바꿨으며, 나머지 필드는 공식 문서 그대로입니다.)

텍스트에 speech tag를 삽입해 어조를 제어할 수 있습니다. 인라인 태그로는 [pause], [laugh] 등이 있고, 감싸는 태그로는 <whisper>…</whisper> 등이 있습니다. WebSocket 스트리밍 엔드포인트(wss://api.x.ai/v1/tts)에는 텍스트 길이 상한이 없으며, team당 동시에 최대 50개의 session을 쓸 수 있습니다.

Custom Voices는 최대 120초의 참조 오디오로 음성을 복제할 수 있습니다(출처: docs.x.ai “Custom Voices”).

• 공식 문서는 90초에서 120초 길이로, 조용한 환경에서 한 명의 화자가 녹음한 음원을 쓰라고 권장하며, 30초 미만의 자료는 디테일이 부족할 수 있습니다.
• Console에서는 사용자 정의 음성을 최대 30개까지 무료로 만들 수 있고, API(POST /v1/custom-voices)로 만드는 것은 Enterprise 요금제로 제한됩니다.
• 공식 문서의 경고: Custom Voices는 현재 미국에서만 제공되며 일리노이주는 제외입니다.

Speech to Text

출처: docs.x.ai “Speech to Text”. 기본 모델은 grok-voice-transcribe-2.0이며, 이전 1.0은 2026-10-02에 종료되어 요청이 자동으로 2.0으로 전환됩니다.

curl -X POST https://api.x.ai/v1/stt \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -F model=grok-voice-transcribe-2.0 \
  -F [email protected]

multipart 필드의 순서에는 규칙이 있습니다. file은 반드시 맨 마지막에 놓아야 하며, 그렇지 않으면 앞의 옵션이 무시될 수 있습니다. 스트리밍 인식은 wss://api.x.ai/v1/stt를 사용하고 오디오는 바이너리 frame으로 전송하며 설정은 주소 파라미터에 넣습니다. STT의 상태 코드에는 400, 401, 413, 429 외에 502(url로 다운로드 실패)와 503(백엔드 일시 사용 불가)이 있습니다.

언어 지원

STT의 언어 수는 공식 페이지 사이에서 일치하지 않습니다. STT 페이지와 Voice Overview는 38개 이상, Release Notes의 출시 공지는 25개, x.ai/voice 마케팅 페이지는 25개 이상이라고 적습니다. STT 페이지에는 코드를 하나씩 나열한 표가 있고 내용이 더 최신이며 더 완전하므로, 실제로 쓸 수 있는 언어는 그 표를 기준으로 삼으십시오.

중국어권 사용자와 관련된 부분입니다.

번체 중국어의 지원 수준은 공식적으로 공개되지 않았습니다. TTS와 Speech to Speech의 언어 표는 간체만 나열하고, STT의 표는 Mandarin만 나열하며, 출력이 번체자인지, 대만 억양이나 대만에서 쓰는 어휘를 지원하는지 설명하는 페이지는 하나도 없습니다. 정식 제품에 쓰기 전에 번체 중국어 원고와 녹음을 직접 준비해 테스트하고, 출시 여부를 결정할 것을 권장합니다.

음성의 Rate limit

출처: docs.x.ai “Rate Limits”이며 Tier 0에서 Tier 4까지 순서대로 나열했습니다.

Tier는 2026-01-01부터의 누적 API 지출에 따라 자동으로 승급되며, Tier별 지출 기준은 docs.x.ai “Rate Limits”를 참조하십시오.

개발 도구, 오류 코드, 기업 기능

이 장은 세 부분으로 나뉩니다. Grok을 개발 도구와 클라우드 플랫폼에 연결하는 방법, API의 오류 코드, 그리고 데이터 보존, 리전, 컴플라이언스처럼 기업이 묻는 사항입니다. 내용은 2026-11-06의 docs.x.ai 페이지를 기준으로 합니다. 공식 문서는 회사를 SpaceXSI라고 부르지만 도메인, 환경 변수, SDK는 여전히 xAI를 그대로 쓰므로, 이 장에서는 xAI로 통일해 적습니다.

개발 도구 개요

Cline, Roo Code, Continue 같은 도구는 대부분 OpenAI 호환 base URL을 지원하므로 이론상 https://api.x.ai/v1을 입력할 수 있습니다. 그러나 이는 추측이며 공식적인 보증이 아니고, xAI는 이들 도구에 대한 설정 안내를 제공하지 않습니다.

Grok Build CLI

출처: docs.x.ai “Grok Build”, “CLI Reference”, “Headless & Scripting”. Grok Build는 xAI의 coding agent이며, 대화형 TUI, 헤드리스 모드(스크립트와 bot)로 쓰거나 Agent Client Protocol(ACP)을 통해 다른 앱에 내장할 수 있습니다. Release Notes는 이를 2026-05에 올렸고 beta로 표시했습니다.

설치와 시작입니다.

curl -fsSL https://x.ai/cli/install.sh | bash

Windows에서는 irm https://x.ai/cli/install.ps1 | iex를 사용합니다. 세 번째는 npm 패키지 @xai-official/grok(npm install -g @xai-official/grok)이며, 공식 기업 배포 페이지는 외부 연결을 제한하는 환경에서는 x.ai를 열어 주지 않고 npm으로 설치할 수 있다고 특별히 밝힙니다. 2026-11-06에 npm registry를 조회했을 때 latest 버전은 1.0.77입니다.

처음 grok을 실행하면 브라우저가 열려 로그인하며, 브라우저가 없는 환경(SSH, 컨테이너)에서는 grok login --device-auth를 쓰거나 XAI_API_KEY를 설정합니다.

cd your-project
grok

헤드리스 모드입니다.

grok -p "Explain this codebase"
grok -p "Explain the architecture" --output-format streaming-json

출력 형식은 plain, json, streaming-json 세 가지입니다. IDE나 다른 프로그램에서 ACP agent로 쓰려면 grok agent stdio 명령을 사용합니다. CI에서는 --no-auto-update를 붙여 백그라운드 업데이트 확인을 피할 것을 권장합니다.

자주 쓰는 하위 명령입니다.

Claude Code 설정 읽기

공식 문서에는 “Claude Code compatibility” 절이 있으며, Grok Build는 아무 설정 없이도 Claude Code의 marketplaces, plugins, skills, MCP, agents, hooks와 CLAUDE.md, CLAUDE.local.md, .claude/rules/를 자동으로 읽어 .grok/와 함께 처리한다고 명시합니다. AGENTS.md 계열 파일과 Cursor의 rules, MCP, hooks도 읽습니다.

실제로 알아 둘 세부 사항은 다음과 같습니다.

• MCP 설정은 ~/.claude.json, .cursor/mcp.json, 프로젝트의 .mcp.json에서 로드되며, 우선순위는 config.toml보다 낮습니다.
• 특정 출처를 끄려면 ~/.grok/config.toml에서 [compat.claude] 또는 [compat.cursor] 아래의 skills, rules, agents, mcps, hooks를 false로 설정하면 되며, GROK_CLAUDE_SKILLS_ENABLED=0 같은 환경 변수도 쓸 수 있습니다.
• Claude Code의 일부 플래그 이름은 별칭으로 쓸 수 있습니다. --allowedTools, --disallowedTools, --append-system-prompt, --system-prompt, --dangerously-skip-permissions입니다.
• 기업 배포에서 이미 MDM으로 Claude Code의 managed-settings.json을 배포했다면, Grok은 그 안의 권한 규칙, MCP 허용 목록, marketplace 제한을 읽습니다. 다만 disableBypassPermissionsMode는 Grok에 적용되지 않으므로, always-approve를 잠그려면 Grok 자체의 requirements.toml에 disable_bypass_permissions_mode = true를 설정해야 합니다.
• 이는 “호환 읽기”이지 Claude Code 안에서 Grok을 호출하는 것이 아닙니다. 공식 문서에는 “Claude Code에서 Grok 모델 사용하기”에 해당하는 문서가 없습니다.

모델, MCP, 비용

• 모델: ~/.grok/config.toml의 예시 파일은 기본 모델을 grok-build로 설정하며, [model.<id>]에 base_url, env_key를 더해 어떤 호환 엔드포인트든 연결할 수 있고, 이후 grok -p "Hello" -m my-model 또는 TUI의 /model로 전환합니다.
• MCP: grok mcp add --transport http linear https://mcp.linear.app/mcp로 원격 server를 추가합니다. 로컬 server는 grok mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem /path/to/dir로 추가하며, --scope project를 붙이면 프로젝트의 .grok/config.toml에 기록됩니다.
• 비용: Grok 4.7 Fast(같은 모델, 2배 속도, 2배 가격)는 Cursor와 Grok Build에서만 제공되고 공개 API에는 없습니다. 공식 문서는 이것이 “Grok Build의 무료 등급에 포함되지 않는다”고 분명히 밝히는데, 이는 Grok Build에 무료 등급이 있다는 뜻이지만 무료 등급의 한도와 조건은 공식 페이지에 공개되어 있지 않습니다. 유료 사용량은 The X Subscription의 플랜을 따릅니다.

Cursor

출처: docs.x.ai “Grok 4.7”과 “The X Subscription”. 공식 모델 페이지는 grok-4.7을 Cursor의 “모든 플랜”에서 쓸 수 있다고 적습니다. The X Subscription은 Grok, Cursor, X를 하나의 구독으로 묶으며, Grok과 Cursor의 자사 사용량은 주간 한도를 공유합니다. Cursor 안에서 서드파티 모델(예: Claude, GPT)을 쓰는 것은 한도에 포함되지 않으며, 처음 사용한 순간부터 API 정가로 과금됩니다.

Vercel AI SDK

출처: docs.x.ai “Community Integrations”. 설치 명령은 npm install ai @ai-sdk/xai zod이며, 기본적으로 환경 변수 XAI_API_KEY를 읽습니다.

import { xai } from '@ai-sdk/xai';
import { generateText } from 'ai';

const { text } = await generateText({
    model: xai.responses('grok-4.7'),
    prompt: 'Write a vegetarian lasagna recipe for 4 people.',
});

key나 base URL을 지정하려면 createXai({ apiKey, baseURL })를 쓰며, 이미지는 generateImage와 xai.image('grok-imagine-image-2.0')를 함께 씁니다.

LiteLLM

출처: docs.x.ai “Community Integrations”. 모델 이름에 xai/ 접두사를 붙입니다.

from litellm import completion
import os

os.environ['XAI_API_KEY'] = ""
response = completion(
    model="xai/grok-4.7",
    messages=[
        {
            "role": "user",
            "content": "What's the weather like in Boston today in Fahrenheit?",
        }
    ],
    max_tokens=10,
    response_format={ "type": "json_object" },
    seed=123,
    temperature=0.2,
    top_p=0.9,
    user="user",
)
print(response)

이 공식 예시는 Chat Completions 형식의 completion을 사용합니다. xAI의 주된 인터페이스는 Responses API이므로 LiteLLM이 이를 지원하는지는 LiteLLM 자체의 xAI provider 문서를 확인하십시오.

Docs MCP Server

출처: docs.x.ai “Docs MCP Server”. xAI는 AI 어시스턴트가 문서를 직접 조회할 수 있는 MCP server를 제공하며, 주소는 https://docs.x.ai/api/mcp이고 Streamable HTTP를 사용하며 상태가 없고, 도구로는 list_doc_pages, get_doc_page, search_docs가 있습니다. 공식 문서가 나열한 설정 방법은 Grok Build, Cursor, Zed, Windsurf, OpenCode를 포함합니다.

grok mcp add --transport http xai-docs https://docs.x.ai/api/mcp
grok mcp doctor xai-docs

Cursor에서는 Settings → MCP에서 추가하고, 유형은 url을 고르고 같은 주소를 입력합니다.

Vertex AI, Foundry, 모델 게이트웨이

Google Cloud Vertex AI(출처: docs.x.ai “Google Cloud Vertex AI”): Grok은 Model Garden의 partner 모델이며, 먼저 Model Garden에서 활성화해야 하고, 이후 OpenAI 호환 인터페이스로 호출하며 Responses API와 Chat Completions를 지원합니다. 모델 이름에 게시자 접두사가 붙으며 예를 들어 xai/grok-4.7이고, 인증에는 Application Default Credentials를 사용합니다. 데이터 보존과 처리는 xAI의 30일 규칙이 아니라 Google Cloud의 정책을 따릅니다. 공식 예시의 base URL은 모델 카드나 Google 문서에 맞춰 입력해야 하며, 페이지에 고정된 값이 제시되어 있지 않습니다.

from openai import OpenAI

client = OpenAI()  # Uses ADC / env vars automatically

response = client.responses.create(
    model="xai/grok-4.7",
    input="Explain the advantages of using Grok for agentic workflows with parallel tool calling.",
    max_output_tokens=800,
)

print(response.output_text)

Microsoft Foundry(출처: docs.x.ai “Microsoft Foundry”): 먼저 Foundry resource와 project를 만든 다음 모델 카탈로그에서 Grok 모델을 배포합니다. “배포 이름”이 곧 model 파라미터의 값이며 생성한 뒤에는 바꿀 수 없습니다. 배포 유형은 Serverless(쓴 만큼 지불) 또는 Provisioned Throughput Units 중에서 고를 수 있습니다. 비용은 Azure Marketplace와 사용자의 Azure 구독을 통해 청구됩니다. 엔드포인트 형식은 https://{resource-name}.services.ai.azure.com/api/projects/{project-name}/openai/v1이며, 공식 문서는 Microsoft Entra ID 인증을 권장하고 key도 지원합니다.

from azure.identity import DefaultAzureCredential, get_bearer_token_provider
from openai import OpenAI

project_endpoint = "https://YOUR-RESOURCE-NAME.services.ai.azure.com/api/projects/YOUR_PROJECT_NAME"
base_url = project_endpoint.rstrip("/") + "/openai/v1"

credential = DefaultAzureCredential()
token_provider = get_bearer_token_provider(
    credential,
    "https://ai.azure.com/.default",
)

client = OpenAI(
    base_url=base_url,
    api_key=token_provider,
)

response = client.responses.create(
    model="grok-4.3",  # your deployment name
    input="Explain the significance of Grok's tool-calling capabilities for building reliable agents. Be concise but insightful.",
    max_output_tokens=800,
)
print(response.output_text)

이 페이지는 Foundry의 Grok을 azure-ai-projects, LangChain, Semantic Kernel, LlamaIndex와 함께 쓸 수 있다고도 언급합니다. 이는 Foundry 페이지의 설명이며, xAI에 LangChain 전용 페이지가 따로 있다는 뜻은 아닙니다.

모델 게이트웨이: grok-4.7 모델 페이지는 OpenRouter, Vercel, Cloudflare 세 게이트웨이를 나열하는데, 페이지에는 이름만 있고 설정 안내는 없습니다. 보안 FAQ는 또한 OpenRouter 같은 게이트웨이를 통해 key 하나를 공유할 때는 최종 사용자마다 다른 safety_identifier를 붙이라고 안내하며, 그래야 위반이 발생했을 때 개별 사용자에게 귀속시킬 수 있습니다.

오류 코드

출처: docs.x.ai “Debugging Errors”. API가 실패하면 보통 HTTP 상태 코드와 오류 메시지를 반환하며, 대부분의 메시지 자체가 원인을 설명합니다.

몇 가지를 보충합니다.

• 공식 오류 코드 페이지에는 5xx 항목이 전혀 없고, 오류 응답 body의 전체 규격도 없습니다. 5xx를 처리하려면 각 엔드포인트 페이지를 참고할 수밖에 없습니다. 예를 들어 TTS와 STT 페이지는 각각 500, 502, 503을 나열하고 백오프 재시도를 권장하며, 비디오 생성의 실패 코드는 이전 장을 참조하십시오.
• 404는 “모델이 존재하지 않거나 사용자의 team에 접근 권한이 없다”는 뜻이기도 하며, body 예시는 {"code":"not-found","error":"The model ... does not exist or your team <team_id> does not have access to it..."}입니다. 미국 리전 엔드포인트에서 목록에 없는 모델(퇴역한 slug와 grok-latest 포함)을 요청해도 이 404를 받습니다.
• key 없이 https://api.x.ai/v1/models를 직접 호출하면 401을 받으며, body는 {"code":"unauthenticated:no-credentials",...}입니다.
• xAI SDK는 gRPC를 사용하며 429는 RESOURCE_EXHAUSTED에 대응합니다.
• 서비스 상태는 https://status.x.ai에서 확인합니다(RSS는 https://status.x.ai/feed.xml). 버그 신고는 [email protected]로 요청, 응답, 관련 로그를 첨부해 보내거나 xAI API Developer Discord의 #help에서 합니다.

데이터 보존과 학습 제외

출처: docs.x.ai “Security” FAQ.

• 기본값: 모든 API 요청과 응답은 암호화된 형태로 xAI 서버에 30일 동안 저장되며, 용도는 남용 감사이고 이후 자동 삭제됩니다.
• 학습 제외: 공식 문서는 xAI가 사용자의 명시적 동의 없이는 API의 입력과 출력으로 모델을 학습하지 않는다고 분명히 밝힙니다.
• Responses API의 서버 측 대화 상태도 마찬가지로 30일간 보존되며, store: false를 보내면 끌 수 있습니다.
• team 관리자는 Console의 Audit Log에서 작업 기록을 볼 수 있습니다. ZDR을 켜면 기록에는 관리 이벤트(예: key 생성, team 변경)만 남고 요청과 응답 내용은 포함되지 않습니다.

ZDR의 트레이드오프

Zero Data Retention(ZDR)은 prompt와 출력을 디스크에 쓰지 않게 합니다. 공식 문서는 이에 대해 신중한 태도를 취하며 “대부분의 고객에게는 켜기를 권하지 않는다”고 하는데, ZDR은 저장에 의존하는 기능을 비활성화하고 ZDR 상태에서 삭제된 내용은 xAI가 나중에 복구하거나 제공할 수 없기 때문입니다.

운영상의 제한입니다.

• ZDR은 team 단위이며 단일 key에만 켤 수는 없습니다.
• team admin이 Console의 Team Settings에서 직접 켜고 끌 수 있으며, 켜기 전에 기존 Files와 Collections를 모두 삭제해야 합니다.
• 켜고 나면 모든 응답의 header에 x-zero-data-retention: "true"가 붙으므로 프로그램이 이를 보고 확인할 수 있습니다.
• ZDR 옵션이 보이지 않는다면 admin이 아니거나, 환경이 아직 셀프 서비스 ZDR을 열지 않았거나, 사용자의 team이 체결한 Enterprise 계약에서 따로 정한 내용이 있기 때문일 수 있으므로 [email protected]에 문의하십시오.

Grok Build CLI에서는 ZDR을 켜면 trace나 코드 데이터를 보존하지 않습니다. ZDR을 켜지 않았다면 /privacy 또는 /settings로 코드 데이터의 보존을 끌 수 있으며, 처음 사용할 때 제품과 모델 개선을 위해 데이터 보존을 허용할지 묻기도 합니다. ZDR 상태에서 Grok Build의 비디오 도구는 S3 호환 저장소를 직접 마련해야 하며 설정은 ~/.grok/managed_config.toml에 하고, 설정하기 전에는 비디오 도구가 오류를 보고합니다.

또한 grok.com의 Build 모드는 session을 넘나들며 App을 게시하기 위해 대화와 build session을 보존하고 Private Chat을 제공하지 않으며, “improve the model”을 켜 두면 이 데이터가 제품과 모델 개선에 사용될 수 있습니다.

미국 리전 엔드포인트

출처: docs.x.ai “Regional Endpoints”. 글로벌 엔드포인트 https://api.x.ai는 처리 지역을 보장하지 않으며, xAI가 용량이나 안정성 때문에 리전 사이에서 조정할 수 있습니다. 요청 처리와 추론을 미국에 두어야 한다면 https://us.api.x.ai/v1을 사용하십시오. 모든 team이 쓸 수 있고 기존 API key를 그대로 쓸 수 있습니다.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("XAI_API_KEY"),
    base_url="https://us.api.x.ai/v1",
)

response = client.responses.create(
    model="grok-4.7",
    input="Explain latency versus throughput in two sentences.",
)

print(response.output_text)

공식 경고는 직설적입니다. 리전 엔드포인트 자체는 완전한 데이터 레지던시 보장이 아니므로, 계약 수준에서 처리나 저장 위치에 대한 요구가 있다면 이에 의존하기 전에 먼저 [email protected]에 문의하십시오. 유럽에 대해서는 API 문서에 EU 리전 엔드포인트 전용 페이지가 없습니다. 일부 모델 페이지의 Regions 열에는 eu-west-1 등의 노드가 나열되어 있지만, 공식 문서는 그것이 API 라우팅 보장이 아니라고 분명히 밝힙니다.

mTLS

출처: docs.x.ai “mTLS Authentication”. mTLS는 기업 기능이며, 유효한 클라이언트 인증서를 제시한 머신만 사용자의 team을 대신해 API를 호출할 수 있도록 보장하는 데 쓰입니다.

1. [email protected]로 메일을 보내 team ID, PEM 형식의 CA 인증서, 클라이언트 인증서의 Common Name을 제공합니다.
2. 활성화된 뒤에는 주소를 https://api.x.ai에서 https://mtls.api.x.ai로 바꾸며, API 경로는 그대로입니다.
3. 모든 요청에 클라이언트 인증서와 개인 키를 첨부하며, 기존의 API key도 여전히 함께 보내야 합니다.

curl https://mtls.api.x.ai/v1/chat/completions \
  --cert /path/to/client-cert.pem \
  --key /path/to/client-key.pem \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{ ... }'

(공식 예시는 여기서 Chat Completions를 사용합니다. 나머지 API 경로와 기능은 mTLS를 활성화한 뒤에도 동작이 같습니다. 요청 본문은 생략했습니다.)

컴플라이언스 인증

출처: docs.x.ai “Security” FAQ와 각 모델 기능 페이지.

GDPR처럼 서면 증빙이 필요한 사안은 문서 페이지의 마케팅 문구 한 줄에만 의존하지 말고, DPA와 Trust Center 자료를 직접 요청하거나 [email protected]에 문의할 것을 권장합니다(맞춤 가격, 월말 청구서, 더 높은 rate limit도 이 경로로 처리하며, https://x.ai/grok/business의 양식을 작성해도 됩니다).

Grok Build의 기업 배포에는 몇 가지 제어 기능도 있습니다. OIDC 싱글 사인온(Entra ID, Okta, Auth0 지원), MDM으로 배포하는 /etc/grok/requirements.toml 강제 설정, 로그인할 team을 고정하는 force_login_team_uuid, 네트워크 허용 목록(핵심 기능에 cli-chat-proxy.grok.com과 auth.x.ai가 필요함)이 있으며, 연결은 전 구간에서 TLS 1.2 또는 1.3을 사용합니다.

정부 조달: GSA OneGov

xAI의 docs.x.ai에는 정부용 플랜 전용 페이지가 없습니다. 확인할 수 있는 1차 자료는 미국 GSA(General Services Administration)의 2025-09-25 보도자료 “GSA and xAI Partner on $0.42 per Agency Agreement to Accelerate Federal AI Adoption”(https://www.gsa.gov/node/166722)이며, 내용은 다음과 같습니다.

• 연방 기관은 기관당 $0.42의 가격으로 Grok 모델을 이용할 수 있습니다.
• 기간은 18개월이며 2027-03까지 유효하고, GSA는 이것이 OneGov AI 협약 중 가장 긴 기간이라고 밝힙니다.
• 협약이 포함하는 모델은 Grok 4와 Grok 4 Fast입니다.
• xAI는 기관의 도입을 돕는 전담 엔지니어를 파견하고 입문 교육을 제공하기로 약속했습니다.
• 협약은 더 많은 기능과 더 높은 rate limit을 위해 FedRAMP 및 DoD Impact Level을 충족하는 Grok 기업 구독으로 업그레이드하는 경로를 제공합니다.

이 보도자료가 적은 것은 계약 체결 당시의 모델입니다. Grok 4와 Grok 4 Fast의 API 이름은 2026-05-15에 퇴역했고 요청은 자동으로 grok-4.3으로 리디렉션됩니다. 그 이후 협약이 포함하는 모델이 갱신되었는지는 GSA의 해당 페이지에 설명이 없습니다. FedRAMP와 DoD IL 인증의 현재 상태도 xAI의 API 문서에는 없으므로, 필요한 기관은 xAI와 GSA에 직접 확인하십시오.

ChatGPT, Claude, Gemini와의 포지셔닝 차이와 자료 출처

이 장은 공식 페이지에서 확인할 수 있는 제품 구조와 정책의 차이만 다루며, 어느 쪽이 더 정확하고 더 안전하고 더 쓰기 좋은지는 평가하지 않습니다. 각 회사가 공개한 benchmark와 순위는 모두 자사가 발표한 것이므로 이 가이드는 비교에 사용하지 않습니다. Claude와 Gemini의 요금제, 가격, 사용량 규칙은 각 회사의 공식 페이지를 직접 확인하십시오. 자주 조정되는 페이지와 어긋나지 않도록 이 장에서는 그 수치를 인용하지 않습니다.

Grok 공식이 강조하는 몇 가지

ChatGPT와 비교: 가격 단계

달러 가격은 각 회사의 공식 가격 페이지에서 가져왔고, 대만 달러는 참고 가격입니다. Grok의 수치는 2026-11-06에 grok.com/plans에 표시된 것이고, ChatGPT의 수치는 같은 날 조회한 ChatGPT 공식 페이지에서 가져왔습니다. 프로모션과 앱 내 구매 가격은 다를 수 있습니다.

Grok 공식의 설명으로는 Premium이 기존 SuperGrok, Cursor Pro, X Premium+를 합친 월 $90 조합에 해당합니다. 이는 공식 문서가 자사의 이전 요금제를 환산한 것이며, 다른 회사 제품과의 동등 비교를 뜻하지 않습니다.

근거가 있는 몇 가지 관찰

1. Grok은 구독을 X와 Cursor에 묶어 두었습니다. The X Subscription의 플랜에는 X 쪽의 혜택(인증 배지, 광고, 크리에이터 도구 등)과 Cursor가 함께 들어 있습니다. 이는 Grok 요금제 구조의 특징이며, 고를 때 “내가 X의 혜택이 필요한가”를 함께 따져야 합니다. 서드파티 모델(예: Cursor 안의 Claude, GPT)은 플랜에 포함되지 않으며 API 정가로 별도 계산됩니다.
2. 실시간 X 데이터는 공식 문서가 분명히 내세운 강점입니다. Grok 공식 페이지는 “공개 X 게시물 검색”을 기능 설명으로 쓰고 답변에 인용이 붙는다고 설명합니다. X의 공개 게시물이 인용될 수 있다는 것은 사용자 본인의 공개 게시물이 Grok의 답변에 나타날 수 있다는 뜻이기도 합니다. 이를 피하려면 공식 방법은 계정을 게시물 보호로 설정하는 것입니다.
3. 이미지와 비디오가 대화와 같은 진입점에 있습니다. Imagine은 grok.com/imagine 또는 대화 스레드에서 쓸 수 있고, 비디오는 참조 이미지와 음성 참조를 지원합니다. 생성물에는 워터마크가 붙고 제거가 금지되어 있으므로, 사용하기 전에 이를 받아들여야 합니다.
4. Grok Bot과 grok.com은 서로 다른 제품입니다. 공식 FAQ는 둘이 다르다고 분명히 밝히며, 로그인 계정(Cursor), 사용량 계산(새 플랜은 공유 풀, 기존 플랜은 독립), 모델 선택(Grok Bot에는 모델 메뉴가 없음)이 모두 다릅니다. “Grok”과 다른 제품의 agent 기능을 비교할 때는 먼저 어느 쪽을 비교하는지 구분해야 합니다.
5. 사용량 규칙은 회사마다 다르고 모두 바뀌고 있습니다. Grok의 주간 공유 사용량 풀은 2026년 6월부터 단계적으로 출시된 새 제도이므로, 2025년의 “Chat 하루 몇 건, Imagine 하루 몇 장” 같은 수치로 계산하지 마십시오.
6. 학습 기본값. 개인용 계정의 내용은 기본적으로 학습에 사용될 수 있으며 Data Controls에서 끌 수 있고, Private Chat은 학습하지 않으며, Business와 Enterprise는 고객 콘텐츠로 학습하지 않습니다. 다른 제품의 기본값이 같은지는 각자의 공식 개인정보 설명과 대조하십시오.
7. 공식 문서가 출력이 부적절할 수 있음을 명시적으로 인정합니다. Grok의 공식 FAQ와 약관은 출력에 욕설, 저속한 유머, 성적 상황, 폭력이 포함될 수 있다고 밝히고 있으며, 호주 약관은 18+ 미디어 노출을 제한하는 설정도 언급합니다(다음 절 참조).

공식이 스스로 보고한 데이터

Grok 공식이 발표한 모델과 순위는 업체 자신의 주장이며, 이 가이드는 전달만 할 뿐 보증하지 않습니다.

• Grok 4.7(2026-09-21): 공식 문서는 “most powerful model for coding and knowledge work”라고 부르며, 지식 컷오프는 2026년 5월, context는 500k입니다.
• Grok 4.5(2026-07): 공식 문서는 “our most intelligent model yet”이라고 부릅니다.
• Imagine Image 2.0: 공식 공지는 Arena의 Image Edit와 Text-to-Image 리더보드(2026-08-07 기준)를 인용해 두 항목 모두 세계 2위라고 밝힙니다. 공지는 또한 xAI의 모델이 Arena에서 “SpaceXAI”라는 이름으로 표시된다고 덧붙입니다.

Grok 4.7이 grok.com의 일반 대화에서 이미 기본으로 활성화되었는지는, 공식 공지가 Cursor, Grok Build, API에서 사용할 수 있다고만 적었고 grok.com 쪽 대응은 공식적으로 공개되지 않았습니다. 로그인한 뒤 app 안에서 확인하십시오.

콘텐츠 정책: 공식 문구만 확인

Grok에는 과거 언론 보도와 커뮤니티 논의에서 다뤄진 콘텐츠 논란이 많이 있습니다. 이 장은 언론 보도나 서드파티 평론을 수록하지 않고, 공식 문서에서 직접 인용할 수 있는 정책 문구만 나열합니다.

이것은 정책 문구이며 실제 집행 효과와 같지는 않습니다. 공식 FAQ도 Grok이 부정확한 정보나 환각을 낼 수 있음을 인정하며 사용자에게 확인을 권장합니다.

어떻게 고를까

• X의 실시간 논의를 조회해야 할 때: 이는 Grok 공식이 분명히 적은 기능이므로, 자신이 관심 있는 주제로 한 번 실제로 써 볼 만합니다.
• 이미 Cursor나 X Premium을 쓰고 있을 때: The X Subscription이 이들을 묶어 두었으므로 합친 뒤의 비용과 새 플랜과 기존 플랜 사이의 전환 규칙을 정확히 계산해야 합니다. 전환은 되돌릴 수 없고 고객 지원도 복원할 수 없습니다.
• 오랜 시간 잡무를 자동으로 처리하는 agent가 필요할 때: 먼저 grok.com 안의 Automations와 Skills가 필요한지, 독립된 Grok Bot이 필요한지 확인하십시오. 세 가지는 사용량과 플랜이 모두 다릅니다.
• 데이터가 학습에 쓰이지 않는 것이 중요할 때: 먼저 Improve the model을 끄고, 민감한 내용에는 Private Chat을 쓰십시오. X 안에서 Grok을 쓴다면 X 설정에서도 따로 끄십시오. 기업 용도라면 Business 또는 Enterprise의 약관을 보십시오.
• 상업용 이미지나 비디오를 만들 때: 먼저 워터마크 규칙을 받아들이고 출력 권리와 표시 요건을 읽어 보십시오.

어느 쪽을 고르든 한도와 플랜은 한두 달 안에 조정될 수 있습니다. 정하기 전에 공식 페이지로 돌아가 그 시점의 조건을 확인하십시오.

자료 출처

아래는 모두 공식 페이지이며 조회일은 2026-11-06입니다. 공식 페이지는 계속 갱신되므로 내용은 각 페이지에 그 시점에 표시되는 것을 기준으로 삼으십시오.

회사 및 제품 공지(x.ai/news)

• xAI joins SpaceX
• The X Subscription
• Grok 4.5, grok.com, X, iOS, Android의 Grok 4.5
• Grok 4.6, Grok 4.7
• Introducing Grok Bot, Grok Bot 요금제 확대, Grok Bot과 X
• Connectors, Skills, Automations
• Build Mode, Grok Build on web and mobile
• Imagine Image 2.0, Imagine Video 1.5 with References
• Grok Voice 3.0, Grok Business
• 뉴스 목록(Office add-in 등 각 공지)

제품 및 가격 페이지

• x.ai/grok, x.ai/grok/business, x.ai/bot, x.ai/build
• x.ai/pricing
• grok.com/plans(대만 달러 표시)
• The X Subscription 가격 안내, 개요

도움말 문서(docs.x.ai)

• Grok 개요, Grok FAQ, Business 사용 가이드
• Connectors
• Grok Bot 개요
• 모델, Release Notes

법률 및 정책

• Terms of Service
• Privacy Policy
• Consumer FAQs
• Acceptable Use Policy
• Safety
• Privacy Portal

X 및 스토어 페이지

• About Grok(X Help Center)
• X Premium(X Help Center)
• Grok의 iOS App Store 페이지
• Grok의 Google Play 페이지

비교용: ChatGPT

ChatGPT의 요금제와 가격 비교는 같은 날 조회한 ChatGPT 공식 가격 페이지에서 가져왔습니다.