Grok 4.5 API 사용법

Grok 4.5는 2026년 7월 8일에 출시되었으며, API 경로를 통해 가장 빠르게 이를 활용할 수 있습니다. 모델 ID는 grok-4.5이며, 가격은 백만 입력 토큰당 $2, 백만 출력 토큰당 $6입니다. 컨텍스트 창은 50만 토큰입니다. xAI의 발표에 따르면, 이 모델은 Musk의 표현을 빌리자면 “Opus급” 역량으로 코딩, 에이전트 작업, 지식 작업에 활용될 수 있습니다.

이 가이드에서는 키를 발급받고, 첫 호출을 하고, grok-4.5와 이전 버전인 grok-4.3 중 선택하는 방법, 그리고 이를 사용하는 어떤 것을 출시하기 전에 Apidog에서 엔드포인트를 올바르게 테스트하는 방법을 안내합니다.

버튼

시작하기 전에 유의할 점 한 가지: Grok 4.5는 아직 EU에서 제품 또는 API 콘솔 모두에서 사용할 수 없습니다. xAI는 2026년 7월 중순에 EU 접근이 가능할 것으로 예상합니다.

1단계: xAI API 키 받기

xAI 콘솔로 이동하여 로그인합니다.
API 키 섹션을 열고 새 키를 생성합니다.
환경 변수로 저장하세요. 절대 하드코딩하지 마세요:

export XAI_API_KEY="xai-..."

새 콘솔 계정은 과거에 체험 크레딧을 받았습니다 (보고에 따르면 $25에서 $150 사이). 특정 금액에 의존하기보다 청구 페이지를 확인하세요. 크레딧 없이 탐색하고 싶다면 Grok 4.5를 무료로 사용하는 방법을 참조하세요.

2단계: 첫 요청 보내기

xAI의 공식 퀵스타트는 Responses 엔드포인트를 사용합니다. 다음은 출시 페이지의 정확한 형태입니다:

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

두 가지 세부 사항이 사람들을 혼란스럽게 합니다:

모델 ID에 점이 포함되어 있습니다. grok-4.5는 작동하지만, grok-4-5는 모델을 찾을 수 없다는 오류를 반환합니다. 슬러그와 URL은 대시를 사용하지만, API 호출은 점을 사용합니다.
퀵스타트는 Responses 형태로 되어 있습니다. messages 배열 대신 input 필드를 사용합니다. xAI는 또한 OpenAI 호환 가능한 채팅 완성 기능을 유지하며, 이는 기존 코드를 마이그레이션하는 경우 중요합니다.

OpenAI SDK 사용하기

xAI는 OpenAI 클라이언트 라이브러리와 호환성을 유지하므로, 기존 클라이언트를 https://api.x.ai/v1로 지정하는 것은 일반적으로 한 줄 변경으로 가능합니다. 이것은 Grok 4.3 API 가이드에서 이전 모델에 대해 다뤘던 것과 동일한 패턴입니다:

from openai import OpenAI

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

response = client.chat.completions.create(
    model="grok-4.5",
    messages=[
        {"role": "system", "content": "You are a code review assistant."},
        {"role": "user", "content": "Review this handler for race conditions: ..."},
    ],
)
print(response.choices[0].message.content)

현재 매개변수 표면에 대해서는 xAI 문서를 확인하십시오. 출시 후 첫 몇 주 동안 기능은 빠르게 변화하므로, 도구 호출 및 구조화된 출력에 대한 진실의 원천은 문서입니다.

스트리밍

대화형 사용을 위해서는 스트리밍을 활성화하고 서버 전송 이벤트를 사용하세요:

stream = client.chat.completions.create(
    model="grok-4.5",
    messages=[{"role": "user", "content": "Refactor this function step by step: ..."}],
    stream=True,
)
for chunk in stream:
    delta = chunk.choices[0].delta.content
    if delta:
        print(delta, end="", flush=True)

Grok 4.5는 초당 약 80토큰을 처리하며, 이는 빠른 모델 영역에 속합니다. 따라서 긴 출력에서도 스트림이 즉각적으로 반응하는 느낌을 줍니다.

3단계: 올바른 모델 ID 선택하기

xAI는 현재 두 가지 주요 채팅 모델을 판매하고 있으며, 이들 간의 장단점은 다음과 같습니다:

	`grok-4.5`	`grok-4.3`
컨텍스트 창	50만 토큰	1백만 토큰
백만당 입력 / 출력	$2.00 / $6.00	$1.25 / $2.50
배치 할인	명시되지 않음	20% 할인
속도	초당 약 80 토큰	xAI의 설명에 따르면 더 느림
강점	에이전트 코딩, 토큰 효율성	긴 컨텍스트 작업, 가격

새 모델은 비용이 더 많이 들고 컨텍스트 창이 절반입니다. 그 대가로 얻는 것은 기능과 효율성입니다: SWE Bench Pro에서 Grok 4.5는 평균 15,954개의 출력 토큰으로 작업을 해결하며, 동일한 벤치마크에서 Claude Opus 4.8 (최대)보다 약 4.2배 적습니다. 에이전트 루프의 경우, 출력 토큰 수가 적다는 것은 더 낮은 요금과 더 짧은 대기 시간을 의미합니다.

경험 법칙: 긴 문서 RAG 및 거대 컨텍스트 분석은 grok-4.3을 사용하고, 다단계 코딩 및 에이전트 도구 사용은 grok-4.5로 이동합니다. 토큰 효율성이 비교를 어떻게 변화시키는지 포함한 전체 비용 계산은 Grok 4.5 가격 설명에 있습니다.

페일오버 또는 통합 청구를 위해 애그리게이터를 통해 라우팅하려면 Grok 4.5는 OpenRouter에도 등록되어 있습니다. 이러한 설정 패턴은 OpenRouter를 통해 Grok 모델을 사용하는 방법에서 다뤘습니다.

4단계: Apidog에서 엔드포인트 테스트하기

Grok 4.5가 프로덕션에 투입되기 전에, 엔드포인트를 적절한 테스트 하네스 아래에 두세요. 다음은 Apidog에서의 워크플로우입니다:

`POST https://api.x.ai/v1/responses` (호환되는 인터페이스를 사용하는 경우 채팅 완성 경로)에 대한 요청을 생성합니다.
Bearer 토큰이 공유 컬렉션에 들어가지 않도록 Apidog 환경에 키를 환경 변수로 저장합니다.
전송 및 검사. Apidog는 SSE 스트림이 도착하는 대로 렌더링하므로, 델타를 확인하고 스트림이 깨끗하게 종료되는지 확인할 수 있습니다.
응답에 대한 단언. 앱이 의존하는 필드(예: 다시 에코되는 모델 이름, 종료 이유, 사용량 카운트)에 시각적 단언을 추가합니다.
두 모델을 A/B 테스트합니다. 요청을 복제하고 grok-4.5를 grok-4.3으로 전환하여 벤치마크 평균을 신뢰하는 대신 실제 프롬프트에서 출력 품질, 지연 시간, 토큰 사용량을 나란히 비교합니다.
모의 테스트. 응답 스키마에서 모의 서버를 생성하여 프롬프트를 조정하는 동안 프런트엔드 및 QA 팀이 안정적인 형태를 기반으로 개발할 수 있도록 합니다. UI 개발에 xAI 크레딧을 소모할 필요가 없습니다.

이 모델에서는 대부분의 다른 모델보다 사용량 객체가 더 중요합니다. Grok 4.5의 강점은 토큰 효율성이므로, 단언에서 작업당 output_tokens를 추적하세요. 어쨌든 프롬프트가 Opus 길이의 출력을 생성한다면, 비용 이점은 줄어듭니다.

따라하고 싶다면 Apidog를 무료로 다운로드하세요. 위의 전체 흐름은 무료 플랜에서 작동합니다.

비용, 제한 및 유의사항

가격: 입력 백만당 $2, 출력 백만당 $6. 웹 및 X 검색 도구 호출은 1,000회 호출당 $5로 별도 청구됩니다. 우선 처리(Priority processing)는 표준 요금의 2배로 실행됩니다.
캐시된 입력: 보조 출처에서는 백만 캐시된 입력당 $0.50의 요율을 보고하지만, 7월 9일 현재 출시 페이지와 문서 가격 페이지 모두 이를 확인하지 않습니다. 캐시 사용량이 많은 비용 모델을 구축하기 전에 콘솔을 확인하십시오.
grok-4.3과 달리 grok-4.5에는 배치 할인이 명시되어 있지 않습니다.
EU: 2026년 7월 중순까지 차단됩니다. EU 청구 계정의 요청은 API 수준이 아닌 콘솔 수준에서 실패하므로, 오류 코드 대신 접근 문제로 나타납니다.
속도 제한은 계정 등급에 따라 다릅니다. Grok의 이전 속도 제한 등급의 패턴이 여전히 적용됩니다: 콘솔 등급을 확인하고 필요하기 전에 백오프 기능을 구축하십시오.

이 모델이 무엇이며 Opus 4.8에 비해 어떤 점에서 우수하거나 뒤처지는지에 대한 더 큰 그림을 보려면 Grok 4.5란 무엇인가부터 시작하십시오.

자주 묻는 질문

Grok 4.5 API 모델 ID는 무엇인가요? grok-4.5입니다. API 호출 시 점(.)이 필요합니다.

Grok 4.5 API가 OpenAI SDK와 호환되나요? 예. `base_url`을 `https://api.x.ai/v1`로 설정하고 xAI 키를 전달하세요. 기존 채팅 완성 코드는 최소한의 변경으로 마이그레이션됩니다.

Grok 4.5 API 비용은 얼마인가요? 백만 입력 토큰당 $2, 백만 출력 토큰당 $6이며, 배치 할인은 명시되어 있지 않습니다. 실제 비용 계산에 대한 자세한 내용은 전체 가격 분석을 참조하십시오.

Grok 4.5를 무료로 호출하는 방법이 있나요? Grok Build 및 Cursor는 제한된 기간 동안 Grok 4.5 무료 사용을 포함하며, 콘솔 체험 크레딧으로 가벼운 API 테스트를 할 수 있습니다. 자세한 내용은 무료 접근 가이드에서 확인하세요.

컨텍스트 창은 얼마인가요? 50만 토큰입니다. 1백만 토큰이 필요하면 `grok-4.3`을 사용하고 기능적 상충 관계를 감수하세요.