/v1/chat/completions 엔드포인트에서 수행할 수 있는 모든 기능을 다룹니다. 모든 결론은 2026년 7월 13일(UTC+8)에 APIYI 게이트웨이를 대상으로 한 실사용 테스트에서 나온 것입니다.
기본 채팅과 스트리밍
6개 모델 모두 표준 OpenAI 형식과 스트리밍을 지원합니다.stream_options: {"include_usage": true}은 작동이 검증되었습니다(최종 청크에 전체 사용량이 포함됩니다):
체인 오브 사고(추론)
이것은 Grok 시리즈에서 가장 자주 오해되는 과금 측면입니다 — 이 섹션 전체를 읽어 보시기 바랍니다.어떤 모델이 체인 오브 사고를 출력하는가
체인 오브 사고와 추론 사용량 읽기
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"}})를 통한 강제 도구 호출도 동작함이 검증되었습니다.
Vision Input (이미지 이해)
Grok 4.x chat 모델은 OpenAI Vision 형식으로 이미지 입력(jpg / png, 이미지당 최대 20MiB)을 허용합니다.grok-4.5 / grok-4.3 / grok-4.20-0309-non-reasoning에서 검증되었으며, 모두 도형과 색상을 정확하게 식별했습니다:
프롬프트 캐싱 (자동)
Grok 접두사 캐싱은 자동으로 동작하며 — 별도 설정이 필요하지 않습니다. 테스트에서는 동일한 접두사 요청의 두 번째 요청부터 2688/2735 token이 캐시 적중되었고, 할인된 캐시 요율로 과금되었습니다:자주 묻는 질문
grok-4.5의 추론 과정을 어떻게 끌 수 있습니까?
grok-4.5의 추론 과정을 어떻게 끌 수 있습니까?
그럴 수 없습니다. 내부 추론은
grok-4.5 / grok-4.3 / grok-build-0.1에 본질적으로 포함되어 있습니다. 추론 과정이 필요 없고 빠르고 저렴한 답변을 원한다면 대신 grok-4.20-0309-non-reasoning을 사용하십시오.reasoning_content를 다음 턴의 컨텍스트에 다시 넣어야 합니까?
reasoning_content를 다음 턴의 컨텍스트에 다시 넣어야 합니까?
아닙니다. 다중 턴 대화에서 기록을 다시 재생할 때는
content만 반환하십시오(도구 호출 필드 추가). reasoning_content은 표준 필드가 아니며 — 이를 다시 보내면 입력 tokens만 불필요하게 늘어납니다.max_tokens를 어떻게 설정해야 합니까?
max_tokens를 어떻게 설정해야 합니까?
추론 과정도 출력 예산을 소모합니다.
max_tokens가 너무 작으면 추론이 전체 예산을 다 써서 보이는 답변이 잘릴 수 있습니다. reasoning 모델은 2048 이상으로 시작하십시오.temperature / top_p가 작동합니까?
temperature / top_p가 작동합니까?
네, 정상적으로 허용됩니다. reasoning 계열 모델은 기존 모델보다 샘플링 매개변수에 덜 민감하므로 조정 여지는 제한적입니다.
관련 문서
Grok 개요
모델 라인업, 가격, 기능 비교표
웹 및 X 검색
서버 측 실시간 검색 도구를 직접 사용해 보기