Grok 매개변수 및 프로토콜 차이

호환 프로토콜에서 Grok 모델의 매개변수 차이와 사용 방법을 알아봅니다.

Grok 추론/샘플링/캐시는 이 페이지에서 조정하세요. 구조: Chat Completions, Responses.

대상 모델

모델	사용 요점
grok-4.7	`low/medium/high/xhigh`, 기본 `high`, 추론 해제 불가. Responses 기본 암호화 추론 반환
grok-4.6	같은 네 강도, 기본 `high`, 해제 불가. 암호화는 `include`로 요청
grok-4.5	`low/medium/high`, 기본 `high`, 해제 불가, `xhigh`는 `high` 취급

xAI는 Chat을 이전 호환 입구, Responses를 주요 API로 분류하며 기존 Messages는 공식 폐기했습니다. 플랫폼이 다른 호환 입구를 중단했다는 의미는 아닙니다.

Chat Completions 차이

필드	차이 설명
`reasoning_effort`	위 강도 사용, `none`으로 추론 끌 수 없음
`temperature`	요청 허용 `0～2`, 실제 최대 `1`. `1` 초과 유효값은 `1`, 필드 폐기 아님
`top_p`	합법 최대 `1`, 실제는 현재 모델 기본 `0.95` 이하. 생략 시 기본값
`presence_penalty/frequency_penalty/stop`	대상 모델 미지원, 전달 시 오류. 일반 Reference 옵션을 옮기지 않음
`logprobs/top_logprobs`	셋 모두 미지원, 조용히 무시. 위 오류 반환과 다름
`tools[].function.strict`	도구 인수는 지원 JSON Schema 준수, `strict` 암시 `true`, `false`로 비엄격 전환 불가
추론 이력	Chat에는 Responses 암호화 추론 필드 없음, 턴 간 암호화 전달은 Responses

Responses 차이

필드	차이 설명
`reasoning.effort`	모델 강도, 기본 `high`, 해제 불가
`temperature/top_p`	샘플링 상한 동일. 응답이 원래 요청을 보여도 실제 상한 초과 적용을 의미하지 않음
페널티와 Logprobs	Chat과 동일. 페널티 미지원, Logprobs 무시, Responses도 다시 추가하지 않음
`max_output_tokens`	가시 답변만 제한, 추론/함수 토큰 제외. 기본 `128000`, OpenAI 합산 예산 아님
`include`	grok-4.6, grok-4.5는 `reasoning.encrypted_content`으로 암호화 요청, grok-4.7은 자동 반환
`store/previous_response_id`	`store` 기본 `true`, 원본 응답 `30`일 보존 및 ID 연장. `store: false`이면 최종 텍스트만 아닌 전체 이력/항목, 암호화 그대로 재전송
`tools[].strict`	함수도 암시 엄격, 인수와 구조는 xAI 지원 부분집합
JSON Schema	`additionalProperties` 기본 `false`, 추가 속성은 명시 `true`. `$ref/$defs`은 비순환 참조만, 재귀 불가
서버 도구	xAI Responses는 `web_search`, `x_search`, `code_interpreter`, 마지막은 원본 SDK의 `code_execution`. 이름 혼용 금지

캐시 차이

필드	차이 설명
자동 접두사 캐시	동일 접두사 자동 재사용, 고정 지시는 앞, 뒤는 추가만, 이력 삭제/재정렬 금지
`x-grok-conv-id`	Chat Header 안정 대화 ID, 캐시 보유 서버로 라우팅 도움. 모델 파라미터 아님
`prompt_cache_key`	Responses 본문의 대응 ID, 매 턴 일정 및 암호화 그대로. 타사 TTL/중단점 추가 안 함
캐시 사용량	Chat `usage.prompt_tokens_details.cached_tokens`, Responses `usage.input_tokens_details.cached_tokens`, 캐시 삭제 가능, 대화 ID로 적중 보장 안 함

미디어 입력 차이

입력	프로토콜 블록	차이 설명
이미지	`image_url`	Chat `image_url.url`은 URL / Base64 Data URL, JPEG / PNG, 장당 최대 `20 MiB`
이미지	`input_image`	Responses `image_url`은 URL / Base64 Data URL 직접, 제한 동일, Chat 객체 아님

셋 모두 텍스트 출력. detail의 auto/low/high은 이미지 처리 정밀도, 이미지 생성 아님.

호출 예제

MODEL_ID을 전체 ID로 바꾸고 대화별 안정 ID 설정. Responses는 수동 이력, 이후 전체 출력/암호화 추론 재전송.

curl 'https://api.agtcloud.ai/v1/chat/completions' \
  -H 'Authorization: Bearer your-api-key' \
  -H 'Content-Type: application/json' \
  -H 'x-grok-conv-id: YOUR_CONVERSATION_ID' \
  --data '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "API 시간 초과 진단 방법을 세 가지로 설명하세요"}],
    "reasoning_effort": "high",
    "max_tokens": 4096
  }'

공식 참고 자료

Grok 4.7 · Grok 4.6 · Grok 4.5 · 모델 제한
추론과 암호화 · 샘플링과 예산 · Chat과 Responses
Chat 호환 입구 · Responses Reference · 이전 API
구조화 출력과 Schema · 서버 도구 · 코드 실행 이름
캐시 대화 ID · 캐시 규칙 · 이미지 입력