Unhinged Grok 사용자를 위한 빠른 시작
Base URL과 API 키를 업데이트하여 기존 OpenAI SDK를 우리의 무검열 LLM API에 5분 안에 연결하세요. 이 가이드는 표준 클라이언트 코드를 사용하여 첫 번째 요청을 보내는 방법을 보여줍니다.
인증 및 기본 URL
우리의 API는 OpenAI와 호환되므로 새 라이브러리가 필요하지 않습니다. 기존 구성에서 두 가지 값만 업데이트하면 됩니다: base_url과 api_key입니다. API 키는 Google 또는 이메일로 가입하는 즉시 생성됩니다. 이 키를 안전하게 보관하세요. 인증에 필요한 유일한 자격 증명입니다.
표준 OpenAI Base URL을 our 엔드포인트로 바꿉니다. 이 변경은 모든 후속 요청을 our 무검열 모델 서버로 보냅니다. 기본 텍스트 생성에는 다른 코드 변경이 필요하지 않습니다.
구성 예시
- Base URL:
https://api.unhingedgrok.com/v1 - API 키: 대시보드에서 발급받은 고유 키
사용 가능한 모델을 나열하여 연결을 확인하세요. 이는 생성 요청을 보내기 전에 인증이 올바르게 작동하고 있음을 확인합니다.
첫 번째 요청
간단한 텍스트 완성 요청부터 시작하세요. 이 예시는 원시 HTTP 구조를 보여주기 위해 curl을 사용합니다. 요청은 모델 ID uncensored로 /v1/chat/completions 엔드포인트를 대상으로 합니다. 응답은 choices 배열에 생성된 텍스트를 반환합니다.
이 직접적인 접근 방식은 표준 OpenAI HTTP 형식을 지원하는 모든 언어나 도구에 적용됩니다. 키를 생성한 직후 즉시 테스트할 수 있습니다.
직접 HTTP 요청
curl https://api.unhingedgrok.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 SDK 통합
공식 OpenAI Python 라이브러리를 사용하여 our API를 통합합니다. pip를 통해 패키지를 설치합니다. 키와 사용자 정의 Base URL을 사용하여 클라이언트를 초기화합니다. chat.completions.create와 같은 나머지 SDK 메서드는 OpenAI에 대해 문서화된 대로 정확히 작동합니다.
이 방법은 백엔드 서비스, 데이터 처리 스크립트 또는 자동화 워크플로우에 이상적입니다. SDK는 JSON 직렬화 및 응답 파싱을 자동으로 처리합니다.
Python 코드 예시
from openai import OpenAI
client = OpenAI(base_url="https://api.unhingedgrok.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 SDK 통합
JavaScript 또는 TypeScript 환경에서는 공식 openai npm 패키지를 사용하십시오. 같은 Base URL과 키로 클라이언트를 구성합니다. Node SDK는 콜백 및 promise 기반 패턴을 모두 지원합니다.
이 설정을 통해 웹 애플리케이션, 서버리스 함수 또는 Node 기반 자동화 도구에 무검열 텍스트 생성을 직접 통합할 수 있습니다. 오류 처리는 표준 OpenAI SDK 동작과 일관됩니다.
Node.js 코드 예시
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unhingedgrok.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: true을 설정하여 실시간 토큰 생성을 활성화하세요. API는 서버 전송 이벤트(SSE) 스트림을 반환합니다. 각 청크에는 부분 응답이 포함됩니다. 마지막 청크에는 토큰 사용 통계가 포함됩니다.
스트리밍은 최종 사용자에게 지각된 지연 시간을 줄입니다. 채팅 인터페이스와 대화형 애플리케이션에 필수적입니다. UI를 즉시 업데이트하려면 각 청크를 점진적으로 처리하십시오.
스트리밍 코드 예시
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)
제한, 오류 및 컨텍스트
서비스 중단을 피하려면 운영 제약을 이해하세요. 컨텍스트 창은 총 100,000개의 토큰을 지원하며, max_tokens이 설정되지 않으면 응답이 창의 끝까지 이어질 수 있습니다.
속도 제한은 키당 분당 300개의 요청을 허용합니다. 동시 요청은 8개로 제한됩니다. 요청 본문은 8 MB를 초과할 수 없습니다. 표준 HTTP 오류 코드를 처리하십시오: 401은 유효하지 않은 키를 나타내고, 402는 부족하거나 모자란 크레딧을 알리며, 429는 속도 제한을 나타냅니다. 오류는 크레딧을 소모하지 않습니다.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| Base URL | https://api.unhingedgrok.com/v1 |
| 인증 | Authorization: Bearer YOUR_KEY |
| 모델 ID | uncensored |
| JSON 모드 | response_format: {"type": "json_object"} |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 속도 제한 | 키당 분당 300회 |
| 요청 크기 | 최대 8 MB |
| 동시 요청 | 키당 동시 8개 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
오류 코드
오류는 고정된 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 | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
이것이 공식 Grok API인가요?
아닙니다. 우리는 자체 무검열 모델을 호스팅하는 독립적인 서비스입니다. X Corp 또는 공식 Grok API와 제휴 관계가 아닙니다. 우리의 API는 OpenAI 클라이언트 형식과 호환되지만 다른 모델을 실행합니다.
사용 요금은 어떻게 지불하나요?
암호화폐(USDT on TRC20 또는 USDC on Base)로 크레딧을 충전합니다. 선불 크레딧은 실제 토큰 사용량에 따라 청구됩니다. 오류와 거부는 무료입니다. 크레딧은 만료되지 않습니다.
컨텍스트 창 크기는 어떻게 되나요?
이 모델은 프롬프트와 결과물을 합쳐 100,000개의 토큰 컨텍스트 창을 지원합니다. 별도의 출력 한도가 없습니다. max_tokens을 지정하지 않으면 응답이 창의 끝까지 이어질 수 있습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.