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

인증

Authorization
string
header
필수

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

API Key 받기:

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

요청 헤더에 추가:

본문

application/json
model
enum<string>
필수

호출할 모델:

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

"grok-4.5"

messages
object[]
필수

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

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

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

예시:

false

max_tokens
integer

생성할 최대 토큰 수. 모델에 그대로 전달됩니다.

예시:

1024

temperature
number

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

예시:

0.7

top_p
number

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

예시:

0.95

tools
object[]

일반 OpenAI function 도구 정의 (클라이언트 측 함수 호출, 호출당 추가 요금 없음). xAI 서버 측 도구는 Responses API에서만 사용할 수 있습니다.

tool_choice

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

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

응답

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

id
string

채팅 완성의 고유 식별자

예시:

"chatcmpl-20260812164515123456789AbCdEfGh"

model
string

실제 사용된 모델 이름

예시:

"grok-4.5"

object
enum<string>

응답 유형

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

"chat.completion"

created
integer

생성 타임스탬프

예시:

1786538000

choices
object[]

채팅 완성 선택지 목록

usage
object

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