Grok API 퀵스타트

Grok API 퀵스타트

xAI API를 처음 써 보려는 분들을 위한 입문 가이드예요. 계정을 만들고 API 키를 발급받아 첫 번째 요청까지, 흐름만 따라가면 됩니다. 여기서는 코드보다 '어떤 순서로 준비하면 되는지'를 중심으로 설명할게요.

출처: xAI 공식 문서 — Quickstart

시작 전에 준비할 것

1. xAI 계정 만들기

console.x.ai에서 계정을 만들고, API를 쓰려면 크레딧을 충전해 두어야 해요. 계정만 만든다고 바로 호출할 수 있는 건 아니라는 점 기억해 두세요.

2. API 키 발급

API Keys 페이지에서 키를 생성한 뒤, 환경변수로 설정합니다.

export XAI_API_KEY="your_api_key"

프로젝트 디렉토리의 .env 파일에 넣어도 됩니다.

XAI_API_KEY=your_api_key

3. SDK 설치

파이썬 기준으로는 다음 명령 하나면 끝나요.

pip install xai-sdk

첫 번째 요청 보내기

grok-4.6 모델로 코딩 프롬프트를 보내 응답을 받아 보는 예시예요. 이 모델은 Grok Build의 에이전트 코딩에도 쓰이며 API에서는 얼리액세스로 제공됩니다.

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.6")
chat.append(user("Fix this function and explain the bug: function median(a){a.sort();return a[a.length/2]}"))

print(chat.sample().content)

다중 턴 대화·추론·구조화 출력이 필요하다면 텍스트 생성 가이드를, 에이전트 코딩 워크플로는 Grok Build 개요를 참고하면 돼요.

이미지 생성까지 해보기

Imagine API로 텍스트 프롬프트에서 이미지를 만들 수도 있어요.

import os
import xai_sdk

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

response = client.image.sample(
    prompt="A futuristic city skyline at sunset",
    model="grok-imagine-image-2.0",
)

print(response.url)

배치 생성·종횡비 제어·이미지 편집 같은 고급 사용법은 이미지 생성 가이드에서 다뤄요.

더 알아보기