Grok API 설정 완전 가이드: xAI 콘솔 가입부터 첫 번째 호출까지 (2026)

Grok API 설정 완전 가이드: xAI 콘솔 가입부터 첫 번째 채팅 완성 호출까지

xAI의 Grok은 강력한 대규모 언어 모델로, API를 통해 자체 애플리케이션에 통합할 수 있습니다. 이 가이드에서는 xAI 콘솔 계정 생성부터 Python으로 첫 번째 채팅 완성 API를 호출하기까지 전체 과정을 단계별로 안내합니다.

사전 준비 사항

• Python 3.8 이상 설치- pip 패키지 관리자- 유효한 이메일 주소 또는 X(Twitter) 계정- 결제 수단 (신용카드 또는 직불카드)

1단계: xAI 콘솔 가입

• xAI 콘솔 접속: 브라우저에서 console.x.ai로 이동합니다.- 계정 생성: “Sign Up” 버튼을 클릭한 후, X(Twitter) 계정 또는 이메일로 가입합니다.- 이메일 인증: 이메일 가입 시 수신된 인증 메일에서 확인 링크를 클릭합니다.- 프로필 설정: 조직 이름과 사용 목적을 입력합니다.- 결제 정보 등록: Settings > Billing 메뉴에서 결제 수단을 등록합니다. xAI는 신규 가입자에게 무료 크레딧을 제공하므로 즉시 과금되지 않습니다.

2단계: API 키 발급

• xAI 콘솔 대시보드에서 “API Keys” 메뉴로 이동합니다.- “Create API Key” 버튼을 클릭합니다.- 키 이름을 입력합니다 (예: my-grok-project).- 생성된 API 키를 즉시 안전한 곳에 복사합니다.⚠️ 중요: API 키는 생성 직후에만 전체 키를 확인할 수 있습니다. 페이지를 벗어나면 다시 볼 수 없으므로 반드시 안전한 곳에 저장하세요.

환경 변수로 API 키 설정

보안을 위해 API 키를 코드에 직접 입력하지 말고 환경 변수로 관리하세요. Linux / macOS: export XAI_API_KEY=“YOUR_API_KEY”

echo ‘export XAI_API_KEY=“YOUR_API_KEY”’ >> ~/.bashrc source ~/.bashrc

Windows (PowerShell): [System.Environment]::SetEnvironmentVariable(‘XAI_API_KEY’,‘YOUR_API_KEY’,‘User’)

3단계: Python SDK 설치

Grok API는 OpenAI 호환 인터페이스를 제공하므로 공식 OpenAI Python SDK를 사용할 수 있습니다. # 가상환경 생성 및 활성화 (권장) python -m venv grok-env source grok-env/bin/activate # Windows: grok-env\Scripts\activate

OpenAI SDK 설치

pip show openai

또는 xAI 전용 SDK를 사용할 수도 있습니다: pip install xai-sdk

4단계: 첫 번째 채팅 완성 호출

기본 예제 (OpenAI 호환 방식)

import os
from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-3",
    messages=[
        {"role": "system", "content": "당신은 친절한 한국어 AI 어시스턴트입니다."},
        {"role": "user", "content": "양자 컴퓨팅을 초등학생도 이해할 수 있게 설명해줘."}
    ],
    temperature=0.7,
    max_tokens=1024,
)

print(response.choices[0].message.content)

스트리밍 응답 예제

import os
from openai import OpenAI

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

stream = client.chat.completions.create(
    model="grok-3",
    messages=[
        {"role": "user", "content": "Python으로 간단한 웹 크롤러를 만드는 코드를 작성해줘."}
    ],
    stream=True,
)

for chunk in stream:
    if chunk.choices[0].delta.content is not None:
        print(chunk.choices[0].delta.content, end="", flush=True)

멀티턴 대화 예제

import os
from openai import OpenAI

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

conversation = [
    {"role": "system", "content": "당신은 요리 전문가입니다."},
]

while True:
    user_input = input("You: ")
    if user_input.lower() in ["quit", "exit"]:
        break
    conversation.append({"role": "user", "content": user_input})
    response = client.chat.completions.create(
        model="grok-3",
        messages=conversation,
    )
    assistant_msg = response.choices[0].message.content
    conversation.append({"role": "assistant", "content": assistant_msg})
    print(f"Grok: {assistant_msg}\n")

사용 가능한 모델 목록

연결 오류가 반복될 경우 다음 진단 스크립트를 실행해보세요: import os from openai import OpenAI

try: client = OpenAI( api_key=os.environ.get(“XAI_API_KEY”), base_url=“https://api.x.ai/v1”, ) models = client.models.list() print(“연결 성공! 사용 가능한 모델:”) for model in models.data: print(f” - {model.id}”) except Exception as e: print(f”연결 실패: {e}“)

자주 묻는 질문 (FAQ)

Q1: Grok API는 무료로 사용할 수 있나요?

xAI는 신규 가입 시 무료 크레딧을 제공합니다. 무료 크레딧 소진 후에는 사용량 기반 요금이 부과됩니다. 정확한 요금은 xAI 콘솔의 Pricing 페이지에서 모델별 입력/출력 토큰당 비용을 확인하세요.

Q2: OpenAI SDK 대신 xAI 전용 SDK를 사용해야 하나요?

Grok API는 OpenAI 호환 인터페이스를 제공하므로 기존 OpenAI SDK로도 완벽하게 작동합니다. 이미 OpenAI 기반 코드가 있다면 base_url과 api_key만 변경하면 됩니다. xAI 전용 SDK는 Grok 고유 기능(예: 실시간 웹 검색 등)을 활용할 때 유리합니다.

Q3: Grok API의 컨텍스트 윈도우 크기는 얼마인가요?

Grok-3 모델은 131,072 토큰의 컨텍스트 윈도우를 지원합니다. 이는 긴 문서 분석이나 대규모 코드 리뷰에 충분한 크기입니다. 다만 입력 토큰이 많을수록 비용이 증가하므로 필요한 컨텍스트만 포함하는 것이 좋습니다.