빠른 시작 for Grok Unrestricted users
기존 OpenAI 호환 클라이언트를 몇 분 안에 무검열 모델에 연결하세요. Base URL과 API 키를 바꾸고 이미 알고 있는 엔드포인트로 요청을 보내세요.
사전 준비사항
요청을 보내기 전에 API 키와 OpenAI 호환 엔드포인트용 클라이언트가 설정되었는지 확인하세요. Google로 계속하기 또는 이메일과 비밀번호로 사이트에 계정을 만드세요. API 키가 즉시 표시되며, 이것이 필요한 유일한 자격 증명입니다. 초기 설정에는 전화번호나 신용카드가 필요하지 않습니다. 엔드포인트를 테스트할 수 있는 7일 유효 기간의 $0.50 무료 체험 크레딧을 받습니다. API 키 페이지에서 한 번의 클릭으로 이 크레딧을 청구하세요. 프로덕션 사용에는 USDT(TRC20) 또는 USDC(Base)로 충전하세요. 이 서비스는 100,000 토큰 컨텍스트 창과 함께 표준 텍스트 입력/출력 워크플로우를 지원합니다.
인증
모든 요청의 Authorization 헤더에 API 키를 포함하세요. Bearer 스키마를 키 문자열 앞에 붙여 사용합니다. 이는 api.grokunrestricted.com 베이스 URL에 대한 계정을 인증합니다. 키가 없거나 유효하지 않으면 API는 인증 실패 오류를 반환합니다. 키가 최신인지 확인하세요. 새 키를 생성하면 이전 키가 대체됩니다. 표준 채팅 완료에는 추가 범위나 권한이 필요하지 않습니다.
채팅 완성 엔드포인트
POST /v1/chat/completions 엔드포인트로 메시지를 보내세요. 모델 ID를 uncensored로 지정하세요. 요청 본문에는 대화 기록이 포함된 messages 배열이 포함되어야 합니다. API는 choices 배열 내에 텍스트 응답을 반환합니다. 이 엔드포인트는 temperature, top_p, stop과 같은 표준 매개변수를 지원합니다. 요청은 실제 토큰 사용량을 기준으로 요금이 청구됩니다. 오류와 거부에는 요금이 부과되지 않습니다.
스트리밍 응답
스트리밍에는 Server-Sent Events(SSE)를 사용하세요. 요청에서stream을 true로 설정하세요. API는 각 청크에 부분 텍스트를 포함하는 청크 스트림을 반환합니다. 마지막 청크에는 요청의 총 토큰 사용량이 포함됩니다. 이 접근 방식은 큰 응답에 대한 지각된 지연 시간을 줄입니다. 공식 SDK를 사용하여 스트림 파싱을 자동으로 처리하세요. 스트리밍은 모든 표준 매개변수와 함께 작동합니다.
함수 호출
요청에 tools 배열을 제공하여 도구 사용을 활성화하세요. 이름, 설명, 매개변수 스키마로 함수 시그니처를 정의하세요. 모델은 적절한 경우 응답에서 도구 호출을 반환합니다. 도구 실행은 사용자 측에서 수행해야 하며, 결과를 후속 메시지에 전달해야 합니다. API는 도구 출력의 정확성을 검증하지 않으며, 결과 처리는 사용자의 책임입니다. tool_choice를 사용하여 모델이 함수를 선택하는 방식을 제어하세요.
JSON 모드
response_format을 {"type": "json_object"}로 설정하여 모델이 유효한 JSON을 출력하도록 강제하세요. 이는 구조화된 데이터 추출이나 구성 생성에 유용합니다. 모델은 JSON 구문 규칙을 따르려고 시도합니다. 프롬프트에서 예상 구조를 명확히 설명하세요. 모델이 복잡한 스키마에 어려움을 겪으면 유효하지 않은 JSON 응답이 발생할 수 있습니다. 파싱하기 전에 클라이언트 측에서 출력을 검증하세요.
cURL
curl https://api.grokunrestricted.com/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
from openai import OpenAI
client = OpenAI(base_url="https://api.grokunrestricted.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)Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.grokunrestricted.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);스트리밍
stream = 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)API 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.grokunrestricted.com/v1 |
| 인증 | Authorization: Bearer YOUR_KEY |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| JSON 모드 | response_format: {"type": "json_object"} |
| 속도 제한 | 키당 분당 300회 |
| 동시 요청 | 키당 동시 8개 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 요청 크기 | 최대 8 MB |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문 and answers
속도 제한은 어떻게 처리합니까?
API 키당 분당 요청 300개, 동시 요청 8개를 허용합니다. 이 한도를 초과하면 API가 오류를 반환합니다. 클라이언트에서 지수 백오프와 함께 재시도 로직을 구현하여 일시적 과부하를 효율적으로 처리해야 합니다.
크레딧이 부족하면 어떻게 되나요?
계정 잔액이 부족하면 요청이 실패합니다. 오류는 무료이므로 자금 부족으로 인한 실패 요청에 대해 요금이 청구되지 않습니다. 암호화폐로 계정을 충전하여 서비스를 계속 이용하세요. 선불 크레딧은 만료되지 않습니다.
컨텍스트 창이 토큰 100k 전체인가요?
네, 프롬프트와 completion을 합쳐 컨텍스트 창은 토큰 100,000입니다. 별도의 출력 한도가 없습니다. max_tokens을 지정하지 않으면 응답이 창의 끝까지 이어질 수 있습니다.
귀하의 key is one form away
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.
API 키 받기