curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "프롬프트 캐싱이 무엇인지 한 문장으로 설명하세요."
    }
  ],
  "reasoning_effort": "xhigh",
  "max_tokens": 2048,
  "prompt_cache_key": "grok-session-001"
}
'

{
  "id": "chatcmpl-20260812164515123456789AbCdEfGh",
  "model": "grok-4.7",
  "object": "chat.completion",
  "created": 1786538000,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Prompt caching reuses previously processed prompt prefixes so repeated context is billed at a lower rate.",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 504,
    "completion_tokens": 2,
    "total_tokens": 526,
    "prompt_tokens_details": {
      "cached_tokens": 0
    }
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/credits"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

Chat Completions API

Grok 전체 모델 인터페이스 - Chat Completions 전체 매개변수

xAI Grok 텍스트 모델용 OpenAI 호환 Chat Completions 엔드포인트. 모델은 model 매개변수로 선택 (전체 값은 model 매개변수의 대조표 참조)
컨텍스트 윈도우 500K 토큰. 프롬프트가 200K 토큰 이상이면 모든 토큰 유형이 2배 요금으로 과금됩니다
프롬프트 캐싱은 자동 적용: 캐시에 적중한 입력 토큰은 더 저렴한 캐시 입력 요금으로 과금됩니다
동기 및 스트리밍(SSE) 모드 지원
일반 function 도구 호출을 지원합니다. 웹 검색, X 검색 등 서버 측 도구에는 Responses API를 권장합니다.
이미지 입력 지원 (jpg / png, 장당 최대 20MiB): content에 콘텐츠 블록 배열을 전달하고 image_url 블록에 공개 URL 또는 base64 데이터 URL을 넣습니다. Grok 4.5 / 4.6 / 4.7 모두 지원

POST

chat

completions

curl --request POST \
  --url https://direct.evolink.ai/v1/chat/completions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "grok-4.7",
  "messages": [
    {
      "role": "user",
      "content": "프롬프트 캐싱이 무엇인지 한 문장으로 설명하세요."
    }
  ],
  "reasoning_effort": "xhigh",
  "max_tokens": 2048,
  "prompt_cache_key": "grok-session-001"
}
'

{
  "id": "chatcmpl-20260812164515123456789AbCdEfGh",
  "model": "grok-4.7",
  "object": "chat.completion",
  "created": 1786538000,
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "Prompt caching reuses previously processed prompt prefixes so repeated context is billed at a lower rate.",
        "tool_calls": [
          {}
        ]
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 504,
    "completion_tokens": 2,
    "total_tokens": 526,
    "prompt_tokens_details": {
      "cached_tokens": 0
    }
  }
}

{
  "error": {
    "code": 400,
    "message": "Invalid request parameters",
    "type": "invalid_request_error"
  }
}

{
  "error": {
    "code": 401,
    "message": "Invalid or expired token",
    "type": "authentication_error"
  }
}

{
  "error": {
    "code": 402,
    "message": "Insufficient quota",
    "type": "insufficient_quota_error",
    "fallback_suggestion": "https://evolink.ai/dashboard/credits"
  }
}

{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "rate_limit_error",
    "fallback_suggestion": "retry after 60 seconds"
  }
}

{
  "error": {
    "code": 500,
    "message": "Internal server error",
    "type": "internal_server_error",
    "fallback_suggestion": "try again later"
  }
}

{
  "error": {
    "code": 503,
    "message": "Service temporarily unavailable",
    "type": "service_unavailable_error",
    "fallback_suggestion": "retry after 30 seconds"
  }
}

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를 받으세요

요청 헤더에 추가:

Authorization: Bearer YOUR_API_KEY

본문

application/json

model

enum<string>

필수

호출할 모델:

모델 ID	포지셔닝
`grok-4.7`	xAI 추론 및 도구 호출 모델. 500K 토큰 컨텍스트 윈도우. `xhigh` 지원. 지식 기준: 2026-05
`grok-4.6`	xAI 추론 + 도구 호출 모델, 컨텍스트 윈도우 500K; `xhigh` 추론 레벨 추가 지원; 지식 컷오프 2026-02-01
`grok-4.5`	xAI 추론 + 도구 호출 모델, 컨텍스트 윈도우 500K; 추론 레벨은 `high`까지(`xhigh`는 허용되지만 `high`로 강등됨)

사용 가능한 옵션:

grok-4.7,

grok-4.6,

grok-4.5

예시:

"grok-4.7"

messages

object[]

필수

채팅 메시지 목록. system, user, assistant 역할을 지원합니다. content는 문자열이거나, 이미지 이해용 콘텐츠 블록(text / image_url) 배열입니다.

Minimum array length: 1

Show child attributes

예시:

[
  {
    "role": "system",
    "content": "You are a concise assistant."
  },
  {
    "role": "user",
    "content": "Explain prompt caching in one sentence."
  }
]

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를 참고하세요.

Show child attributes

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 스트림)

string

채팅 완성의 고유 식별자

예시:

"chatcmpl-20260812164515123456789AbCdEfGh"

model

string

실제 사용된 모델 이름

예시:

"grok-4.7"

object

enum<string>

응답 유형

사용 가능한 옵션:

chat.completion

예시:

"chat.completion"

created

integer

생성 타임스탬프

예시:

1786538000

choices

object[]

채팅 완성 선택지 목록

Show child attributes

usage

object

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

Show child attributes

이미지 시리즈

비디오 시리즈

오디오 시리즈

텍스트 시리즈

계정 관리

작업 관리

파일 관리

Grok 전체 모델 인터페이스 - Chat Completions 전체 매개변수

Grok 4.7 사용 방법

인증

본문

응답

​Grok 4.7 사용 방법

인증

본문

응답

Grok 4.7 사용 방법