API 문서

인증 및 Base URL

모든 요청의 base URL은 https://api.grokapiplatform.com/v1. 고유한 API 키를 다음에 전달하여 인증하세요: Authorization header. 모든 요청에는 계정 잔액을 확인하고 속도 제한을 적용하기 위해 이 헤더가 포함되어야 합니다.

채팅 완료 엔드포인트

에 텍스트 쿼리를 보내세요 POST /v1/chat/completions. 사용할 모델 ID는 "uncensored"입니다. 이 엔드포인트는 기본 사용에 추가 구성 없이 표준 텍스트 입력/출력 상호작용을 처리합니다.

Copycurl https://api.grokapiplatform.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Check my current token usage balance."}]
  }'

이 모델은 100,000개의 토큰 컨텍스트 창으로 작동합니다. 입력 및 출력 토큰은 이 제한을 공유합니다. 컨텍스트 창을 초과하는 요청은 즉시 실패합니다.

SSE를 통한 스트리밍 응답

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청 본문에 포함하세요. 서버는 점진적인 토큰 업데이트를 포함하는 서버 전송 이벤트(SSE)를 반환합니다. 실시간 표시 또는 지각된 지연 시간 감소를 위해 이를 사용하세요.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokapiplatform.com/v1", api_key="YOUR_KEY")

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Summarise this thread without softening it."}],
)
print(resp.choices[0].message.content)

토큰 사용량 세부 정보는 스트림의 마지막 청크에 표시됩니다. 각 중간 델타를 파싱하지 않고도 요청별 총 소비량을 추적할 수 있습니다.

함수 호출 및 도구

다음에 도구를 정의하세요 tools 배열 및 설정 tool_choice 특정 동작을 트리거합니다. 모델은 OpenAI SDK와 호환되는 표준 도구 사용 패턴을 지원합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokapiplatform.com/v1", apiKey: process.env.API_KEY });

const resp = await client.chat.completions.create({
  model: "uncensored",
  messages: [{ role: "user", content: "Draft a villain monologue for my game." }],
});
console.log(resp.choices[0].message.content);

사용 tool_choice: "auto" 자동 선택 또는 강제 실행을 위해 도구 이름을 지정하세요. 이는 복잡한 추론 작업에 비검열 모델과 원활하게 작동합니다.

구조화된 출력을 위한 JSON 모드

設定 response_format 수신하여 {"type": "json_object"} 엄격한 JSON 출력을 강제합니다. 이는 프론트엔드 애플리케이션이나 데이터 파이프라인과의 통합 시 파싱 오류를 줄입니다.

매개변수 및 한도

조정 temperature, top_p, 그리고 seed 무작위성을 제어합니다. 요청당 최대 출력은 16,000 토큰입니다. 401 오류는 유효하지 않은 키를, 402는 부족 선불 크레딧을, 429는 속도 제한을 의미합니다. 제한은 키당 분당 300회 요청입니다. 크레딧은 만료되지 않으므로 필요할 때 언제든지 USDT 또는 USDC로 충전할 수 있습니다.

스트리밍

Copystream = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Tell the story in second person."}],
    stream=True,
)
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)