Grok 시리즈

xAI의 Grok 모델로, 추론（reasoning）모델 Grok 4.7, 4.6, 4.5, 4.3과 비추론 모델 Grok 4.1 Fast, 4.20이 있습니다. OpenAI 호환 API로 호출합니다.

자주 하는 작업

모델

전체 모델 목록과 실시간 가격은 모델 페이지 를 참고하십시오. 모델 ID의 접두사는 x-ai/이며 생략할 수 있습니다.

엔드포인트 지원

Grok 모델은 xAI 공식（grok）이 제공하며, 일부 모델은 Azure AI Foundry 공급자도 있습니다.

호출 예시

import os
from openai import OpenAI
 
client = OpenAI(base_url="https://api.ofox.ai/v1", api_key=os.environ["OFOX_API_KEY"])
 
resp = client.chat.completions.create(
    model="x-ai/grok-4.7",
    reasoning_effort="low",
    messages=[{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}],
)
print(resp.choices[0].message.content)
print("추론 토큰:", resp.usage.completion_tokens_details.reasoning_tokens)

curl https://api.ofox.ai/v1/chat/completions \
  -H "Authorization: Bearer $OFOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "x-ai/grok-4.7",
    "reasoning_effort": "low",
    "messages": [{"role": "user", "content": "멱등성이 무엇인지 한 문장으로 설명해 주세요."}]
  }'

추론

같은 수학 문제로 실측한 결과, Grok 4.7은 기본 설정에서 추론 토큰 약 1만 5천 개, 약 4분이 걸렸고, reasoning_effort: "low"에서는 약 4,200개, 약 1분이 걸렸습니다. 추론 토큰은 출력 단가로 과금되며, 개수는 usage.completion_tokens_details.reasoning_tokens에서 확인할 수 있습니다. 추론 내용은 스트리밍 응답의 delta.reasoning_content에 담깁니다.

기타 기능

• 이미지 입력: Grok 4.3, 4.20, 4.1 Fast가 지원하며, 표준 image_url 콘텐츠 블록을 사용합니다. 작성법은 비전을 참고하십시오.
• 구조화된 출력과 도구 호출: response_format은 json_schema를 지원하며, 도구 호출은 표준 tools 파라미터를 사용합니다.
• 캐시: 반복되는 요청 접두부를 자동으로 캐시하며, 적중량은 usage.prompt_tokens_details.cached_tokens에서 확인할 수 있습니다.

자주 발생하는 오류

기타 공통 오류는 오류 처리를 참고하십시오.

공식 문서

• xAI · 문서 

자주 묻는 질문