Grok 사용자용 Quickstart

기본 URL 및 인증

당사 API는 OpenAI SDK와 완전히 호환됩니다. base_url만 업데이트하고 Authorization 헤더에 키를 제공하면 됩니다. Google 또는 이메일로 가입하여 키를 즉시 받으세요. 시작하려면 전화번호나 신용카드가 필요하지 않습니다. 모든 요청에 uncensored 모델 ID를 사용하세요.

인증은 Bearer 토큰을 통해 처리됩니다. 키가 모든 요청 헤더에 전송되는지 확인하세요. 401 오류가 발생하면 키가 유효하지 않거나 만료된 것입니다. 당사는 독립적인 서비스이며 타사 모델을 재판매하지 않습니다.

기본 채팅 완료

표준 POST 요청을 /v1/chat/completions로 보내세요. API는 텍스트 입력을 받아 텍스트 출력을 반환합니다. 시스템 프롬프트를 정의하여 모델의 동작을 안내할 수 있습니다. 모델은 합법적인 성인 콘텐츠, 소설, 논쟁적인 주제에 대해 거부 없이 응답합니다.

페이로드에서 모델을 uncensored로 지정하세요. 컨텍스트 창은 총 100,000 토큰까지 지원합니다. 요청당 최대 출력은 32,000 토큰입니다. 오류와 거부는 크레딧을 소모하지 않습니다.

스트리밍 응답

stream: true를 설정하여 스트리밍을 활성화하세요. API는 Server-Sent Events(SSE)를 반환합니다. 각 청크에는 증분 텍스트 업데이트가 포함됩니다. 마지막 청크에는 청구 투명성을 위한 토큰 사용 통계가 포함됩니다.

스트리밍은 실시간 UI 업데이트에 이상적입니다. SSE 스트림을 구문 분석하여 생성되는 대로 텍스트를 표시하세요. 이는 사용자의 지각된 지연 시간을 줄입니다. API는 스트리밍 프로토콜을 자동으로 처리합니다.

함수 호출

tools 매개변수에서 도구를 정의하세요. 모델은 구조화된 함수 호출을 반환할 수 있습니다. tool_choice을 사용하여 특정 동작을 강제하세요. 이를 통해 외부 시스템 및 워크플로우와 통합할 수 있습니다.

함수 호출은 표준 OpenAI 형식으로 작동합니다. 응답을 구문 분석하여 요청된 도구를 실행하세요. 모델은 함수 호출 간 컨텍스트를 유지합니다. 이는 자동화 에이전트 및 데이터 추출 작업에 유용합니다.

JSON 모드

엄격한 JSON 출력을 위해 response_format을 {"type": "json_object"}로 설정하세요. 모델은 응답을 유효한 JSON 형식으로 포맷합니다. 이는 애플리케이션에서 구조화된 데이터를 구문 분석하는 데 유용합니다.

JSON 모드는 일관된 포맷을 보장합니다. 하류 코드가 특정 스키마 구조를 기대할 때 사용하세요. 모델은 요청된 형식을 준수합니다. 이는 추가 구문 분석 로직의 필요성을 줄입니다.

매개변수, 제한 및 오류

temperature, top_p, stop 시퀀스로 생성을 제어하세요. 속도 제한은 키당 분당 300개 요청입니다. 최대 8개의 동시 요청을 가질 수 있습니다. 요청 본문은 8 MB를 초과할 수 없습니다. 402 오류는 크레딧 부족을 의미합니다. 429 오류는 속도 제한에 도달했음을 의미합니다. 크레딧은 선불이며 만료되지 않습니다. 오류는 무료입니다.

cURL

Copycurl https://api.grokuncensored.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.grokuncensored.cc/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)

Node.js

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.grokuncensored.cc/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);

스트리밍

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)