Skip to main content
POST
Grok 대화 완성 (전체 모델, 전체 매개변수)
BaseURL: 기본 BaseURL은 https://direct.evolink.ai이며, 텍스트 모델 지원이 더 우수하고 장시간 연결을 지원합니다. https://api.evolink.ai는 멀티모달 서비스의 주력 엔드포인트이며, 텍스트 모델에 대해서는 대체 주소로 사용됩니다.
이 페이지는 일반 function 호출을 설명합니다. 서버 측 도구(웹 검색, X 검색, 코드 실행, 첨부 파일 검색, 컬렉션 검색)는 도구 설정과 과금을 설명하는 Responses API를 권장합니다.

Grok 4.7 사용 방법

model을 grok-4.7로 설정하고 기존 messages 요청 형식을 유지하세요. 컨텍스트 윈도우는 500,000 토큰이며 지식 기준은 2026년 5월입니다. 최상위 reasoning_effort 매개변수를 사용하세요. 추론 깊이: low / medium / high(기본값) / xhigh. 추론은 끌 수 없습니다. grok-4.7과 grok-4.6은 xhigh를 지원하며, grok-4.5는 이 값을 받지만 high로 처리합니다. 추론 토큰은 출력 토큰으로 과금됩니다. prompt_cache_key는 동일한 프롬프트 접두사를 공유하는 요청에 안정적인 캐시 라우팅 힌트를 제공하지만 캐시 적중을 보장하지 않습니다. 실제 적중량은 usage.prompt_tokens_details.cached_tokens를 확인하세요. 여러 대화 턴에서 암호화된 추론을 유지하려면 Responses API를 사용하세요.

인증

Authorization
string
header
필수

##모든 API는 Bearer Token 인증이 필요합니다##

API Key 받기:

API Key 관리 페이지를 방문하여 API Key를 받으세요

요청 헤더에 추가:

본문

application/json
model
enum<string>
필수

호출할 모델:

사용 가능한 옵션:
grok-4.7,
grok-4.6,
grok-4.5
예시:

"grok-4.7"

messages
object[]
필수

채팅 메시지 목록. system, user, assistant 역할을 지원합니다.

Minimum array length: 1
예시:
stream
boolean
기본값:false

스트리밍으로 응답을 반환할지 여부 (SSE, chat.completion.chunk 이벤트). 기본값 false.

예시:

false

max_tokens
integer

생성할 최대 토큰 수.

예시:

1024

reasoning_effort
enum<string>
기본값:high

추론 깊이: low / medium / high(기본값) / xhigh. 추론은 끌 수 없습니다. grok-4.7과 grok-4.6은 xhigh를 지원하며, grok-4.5는 이 값을 받지만 high로 처리합니다. 추론 토큰은 출력 토큰으로 과금됩니다.

사용 가능한 옵션:
low,
medium,
high,
xhigh
temperature
number

샘플링 온도 (0-2). 값이 클수록 출력이 더 무작위해집니다.

예시:

0.7

top_p
number

Nucleus 샘플링 매개변수 (0-1).

예시:

0.95

tools
object[]

이 페이지는 일반 OpenAI function 도구 정의를 설명합니다(클라이언트 측 함수 호출로, 서버 측 도구 호출 요금은 없습니다). 웹 검색과 X 검색 등 서버 측 도구의 설정 및 사용량은 Responses API를 참고하세요.

tool_choice

함수 선택을 제어합니다: "auto" / "none" / "required", 또는 특정 함수를 지정하는 객체.

사용 가능한 옵션:
auto,
none,
required
prompt_cache_key
string

선택적 캐시 라우팅 키입니다. 같은 대화 또는 동일한 프롬프트 접두사를 공유하는 요청에 일관된 값을 사용하면 캐시 적중 가능성을 높일 수 있습니다. 적중을 보장하지 않으며 캐시 과금 규칙도 바뀌지 않습니다. 실제 적중량은 usage의 cached_tokens를 확인하세요.

예시:

"grok-session-001"

응답

채팅 완성이 성공적으로 생성되었습니다 (JSON 객체, 또는 stream=true인 경우 chat.completion.chunk 이벤트의 SSE 스트림)

id
string

채팅 완성의 고유 식별자

예시:

"chatcmpl-20260812164515123456789AbCdEfGh"

model
string

실제 사용된 모델 이름

예시:

"grok-4.7"

object
enum<string>

응답 유형

사용 가능한 옵션:
chat.completion
예시:

"chat.completion"

created
integer

생성 타임스탬프

예시:

1786538000

choices
object[]

채팅 완성 선택지 목록

usage
object

토큰 사용 통계. 프롬프트가 200K 토큰 이상이면 모든 토큰 유형(입력, 캐시 입력, 출력)이 2배로 과금됩니다.