Skip to main content
이 페이지에서는 Grok 시리즈가 /v1/chat/completions 엔드포인트에서 수행할 수 있는 모든 기능을 다룹니다. 모든 결론은 2026년 7월 13일(UTC+8)에 APIYI 게이트웨이를 대상으로 한 실사용 테스트에서 나온 것입니다.

기본 채팅과 스트리밍

6개 모델 모두 표준 OpenAI 형식과 스트리밍을 지원합니다. stream_options: {"include_usage": true}은 작동이 검증되었습니다(최종 청크에 전체 사용량이 포함됩니다):
측정된 스트리밍 첫 토큰까지의 시간은 모든 모델에서 1.5–2.3초이며, 비스트리밍 단답형 Q&A는 전체적으로 1.7–5.1초에 완료됩니다.

체인 오브 사고(추론)

이것은 Grok 시리즈에서 가장 자주 오해되는 과금 측면입니다 — 이 섹션 전체를 읽어 보시기 바랍니다.

어떤 모델이 체인 오브 사고를 출력하는가

추론 token은 출력 과금에 포함됩니다. 한 번 측정한 짧은 Q&A에서는 보이는 답변이 30 token에 불과했지만 586 출력 token이 과금되었으며(그중 556개는 추론이었습니다). 고빈도 짧은 Q&A에서는 grok-4.20-0309-non-reasoning이 상당히 절약됩니다.

체인 오브 사고와 추론 사용량 읽기

reasoning_effort 매개변수

reasoning_effort(예: "low" / "high")는 grok-4.5에서만 허용됩니다; grok-4.20-0309-reasoning는 이를 400 Model ... does not support parameter reasoningEffort로 명시적으로 거부합니다. 모델 간 코드에 이 매개변수를 하드코딩하지 마십시오.

구조화된 출력

OpenAI 표준 response_format: json_schema(strict mode)이 지원됩니다. grok-4.5 / grok-4.3 / grok-build-0.1 / grok-4.20-0309-reasoning 및 멀티 에이전트 모델에서 검증된 통과가 확인되었으며, 모두 스키마를 엄격하게 준수하는 JSON을 반환합니다:

함수 호출

OpenAI 표준 tools / tool_choice 필드와 전체 2라운드 도구 호출 흐름을 지원합니다(grok-4.5 / grok-4.3 / grok-build-0.1에서 검증됨):
tool_choice({"type": "function", "function": {"name": "get_weather"}})를 통한 강제 도구 호출도 동작함이 검증되었습니다.
이 섹션은 클라이언트 측 함수 호출에 관한 것입니다(사용자 코드가 도구를 실행합니다). xAI의 서버가 대신 검색하거나, 코드를 실행하거나, MCP에 연결하게 하려면 Responses API를 사용하십시오. 웹 및 X 검색코드 실행 및 MCP를 참조하십시오.

Vision Input (이미지 이해)

Grok 4.x chat 모델은 OpenAI Vision 형식으로 이미지 입력(jpg / png, 이미지당 최대 20MiB)을 허용합니다. grok-4.5 / grok-4.3 / grok-4.20-0309-non-reasoning에서 검증되었으며, 모두 도형과 색상을 정확하게 식별했습니다:
base64 data URL을 우선 사용하십시오. 외부 URL을 사용하면 이미지는 xAI의 상위 서버에 의해 직접 가져와집니다. 테스트에서는 일부 이미지 호스트(예: Wikimedia)가 서버 측 가져오기를 거부하여 image_download_error로 요청이 실패했습니다. 외부 URL을 반드시 사용해야 한다면, 호스트가 서버 측 접근을 허용하는지 확인하고 URL이 이미지 파일을 직접 가리키는지 확인하십시오.

프롬프트 캐싱 (자동)

Grok 접두사 캐싱은 자동으로 동작하며 — 별도 설정이 필요하지 않습니다. 테스트에서는 동일한 접두사 요청의 두 번째 요청부터 2688/2735 token이 캐시 적중되었고, 할인된 캐시 요율로 과금되었습니다:
최적화: 안정적인 콘텐츠(system prompt, few-shot 예시)는 메시지 앞부분에 두고, 변동되는 콘텐츠는 끝부분에 두어 접두사 적중을 최대화합니다. APIYI 게이트웨이는 키 풀 모드로 동작하므로, 적중률에 대해서는 합리적인 기대치를 설정하십시오(100%는 보장되지 않음). 과금 세부 정보는 캐시 과금에서 확인할 수 있습니다.

자주 묻는 질문

그럴 수 없습니다. 내부 추론은 grok-4.5 / grok-4.3 / grok-build-0.1에 본질적으로 포함되어 있습니다. 추론 과정이 필요 없고 빠르고 저렴한 답변을 원한다면 대신 grok-4.20-0309-non-reasoning을 사용하십시오.
아닙니다. 다중 턴 대화에서 기록을 다시 재생할 때는 content만 반환하십시오(도구 호출 필드 추가). reasoning_content은 표준 필드가 아니며 — 이를 다시 보내면 입력 tokens만 불필요하게 늘어납니다.
추론 과정도 출력 예산을 소모합니다. max_tokens가 너무 작으면 추론이 전체 예산을 다 써서 보이는 답변이 잘릴 수 있습니다. reasoning 모델은 2048 이상으로 시작하십시오.
네, 정상적으로 허용됩니다. reasoning 계열 모델은 기존 모델보다 샘플링 매개변수에 덜 민감하므로 조정 여지는 제한적입니다.

관련 문서

Grok 개요

모델 라인업, 가격, 기능 비교표

웹 및 X 검색

서버 측 실시간 검색 도구를 직접 사용해 보기