Grok API 통합 가이드
기업 필터링이나 월별 구독 피로 없이 LLM 워크플로우를 위한 신뢰할 수 있는 Uncensored API가 필요합니다. 이 가이드는 표준 OpenAI 호환 프로토콜을 사용하여 Uncensored 모델을 통합하는 방법을 설명하며, 성인 또는 제한 없는 사용 사례에 대한 원본 텍스트 생성을 보장합니다. 요청이 올바르게 처리되도록 하는 기술적 단계를 자세히 설명합니다.
마지막 업데이트
핵심 요약
숨겨진 거부 없이 텍스트를 보내고 원본 응답을 받을 수 있는 표준 POST /v1/chat/completions 엔드포인트를 사용하세요.
애플리케이션 스레드를 차단하지 않고 긴 출력을 효율적으로 처리하기 위해 서버 전송 이벤트(Server-Sent Events)를 통한 스트리밍을 구성하세요.
무검열 모델 컨텍스트를 유지하면서 구조화된 데이터 추출을 위해 함수 호출과 JSON 모드를 활용하세요.
가격은 선불 방식이며 입력 및 출력 토큰 수에 엄격하게 기반하므로 토큰 사용량을 주의 깊게 모니터링하세요.
Grok API 대안용 비검열을 사용하는 이유?
직접 API 액세스는 종종 합법적인 성인 또는 논쟁적인 주제를 차단하는 엄격한 콘텐츠 필터를 적용합니다. 많은 제공업체는 이러한 거부를 응답 구조의 깊은 곳에 숨깁니다. 비검열 모델은 모든 합법적인 사용 사례에 대한 원시 추론 데이터를 제공합니다. 기업 안전 계층이 개입하지 않고 전체 출력을 얻습니다.
기업급 API는 통보 없이 필터링 로직을 변경할 수 있습니다. 이는 특정 콘텐츠 유형에 의존하는 다운스트림 애플리케이션을 중단시킵니다. 전용 uncensored 서비스은 이러한 불확실성을 제거합니다. 프롬프트는 모델이 생성한 그대로 정확하게 반환됩니다.
채팅 인터페이스와 원시 API의 차이를 고려하세요. 채팅 UI는 미세한 출력을 숨길 수 있습니다. API는 전체 토큰 스트림을 노출합니다. 이러한 투명성은 특수 도구를 구축하는 개발자에게 중요합니다.
저희 서비스는 독립적으로 운영됩니다. Grok나 기타 벤더의 모델을 제공하지 않습니다. 별도의 비검열 대규모 언어 모델을 제공합니다. 자체 서버에서 실행되며 인터페이스는 OpenAI 사용자에게 익숙합니다.
주요 혜택
- 월 구독료 없음.
- 투명한 선불 청구.
- 합법적인 성인 콘텐츠에 대한 원본 출력.
- 논쟁적인 주제에 대한 숨겨진 거부 없음.
API 엔드포인트 구조 이해하기
두 개의 엔드포인트가 모든 상호작용을 처리합니다: POST /v1/chat/completions 및 GET /v1/models. 이는 표준 OpenAI API 사양을 따릅니다. 시스템 및 사용자 메시지가 포함된 JSON 페이로드를 전송합니다. 서버는 생성된 텍스트가 포함된 JSON 응답을 반환합니다.
GET 엔드포인트는 사용 가능한 모델 목록을 반환합니다. 연결이 유효한지 확인합니다. 이 엔드포인트를 사용하여 API 키가 작동하는지 확인한 후 부하를 많이 보내야 합니다. 또한 요청에 포함해야 하는 모델 ID도 표시됩니다.
기본 URL은 HTTPS://api.isgrokunfiltered.com/v1입니다. 이는 클라이언트 구성의 기본 OpenAI URL을 대체합니다. 전송해야 할 모델 ID는 "uncensored"입니다. 이는 올바른 서버에 접근하도록 보장합니다.
인증은 Authorization 헤더의 Bearer 토큰을 사용합니다. API 키를 직접 포함하세요. 복잡한 OAuth 플로우가 필요하지 않습니다. 이 단순성은 통합 시간을 크게 단축합니다.
엔드포인트 요약
| 메서드 | 경로 | 함수 |
|---|---|---|
| POST | /v1/chat/completions | 텍스트 응답을 생성합니다 |
| GET | /v1/models | 사용 가능한 모델 나열 |
스트리밍용 클라이언트 구성
요청 본문에서 stream 파라미터를 true로 설정하여 스트리밍을 활성화하세요. 이는 단일 JSON 객체 대신 서버 전송 이벤트(SSE)를 반환합니다. 각 이벤트에는 응답의 부분 청크가 포함됩니다. 이를 통해 사용자에게 실시간으로 텍스트를 표시할 수 있습니다.
스트리밍은 긴 응답의 지각된 지연 시간을 줄입니다. 사용자는 생성되는 대로 출력을 봅니다. 이는 채팅과 유사한 인터페이스의 경험을 향상시킵니다. 필요한 경우 요청을 조기에 취소할 수도 있습니다.
각 청크에는 마지막 이벤트에 토큰 사용 데이터가 포함됩니다. 입력 및 출력 토큰을 정확하게 추적할 수 있습니다. 이를 통해 선불 크레딧 잔액을 모니터링할 수 있습니다. 스트리밍 중 오류가 발생해도 처리된 데이터에 대한 토큰이 소모됩니다.
SSE 형식을 올바르게 처리하세요. "data: "로 시작하는 각 줄을 파싱하세요. 마지막 "[DONE]" 이벤트를 무시하세요. 이렇게 하면 애플리케이션이 모든 토큰을 올바르게 처리합니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.isgrokunfiltered.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)
uncensored 모드에서의 함수 호출 처리
함수 호출을 통해 애플리케이션이 모델 출력에 기반하여 코드를 실행할 수 있습니다. 요청에 도구 목록을 보내세요. 모델은 일반 텍스트 대신 tool_calls 배열을 반환합니다. 코드가 함수를 실행하고 결과를 다시 전송합니다.
이것은 우리의 무검열 모델과 원활하게 작동합니다. 모델은 콘텐츠 유형에 기반하여 함수 호출을 거부하지 않습니다. 요청의 논리적 구조에 집중합니다. 이는 복잡한 데이터 추출 작업에 이상적입니다.
엄격한 출력 형식을 강제하기 위해 JSON 모드를 사용하세요. response_format을 json_object로 설정하세요. 모델은 유효한 JSON만 반환합니다. 이는 백엔드에서 구문 분석 오류를 줄입니다. 일관된 데이터 구조를 보장합니다.
동적 상호작용을 위해 함수 호출과 스트리밍을 결합하세요. 모델이 여전히 생성 중일 때 함수 실행을 시작할 수 있습니다. 이는 매우 반응이 빠른 애플리케이션을 만듭니다. Uncensored 모델은 편향 없이 다양한 도구 정의를 처리합니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.isgrokunfiltered.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);
긴 컨텍스트를 위한 토큰 비용 최적화
컨텍스트 윈도우는 최대 100,000개의 토큰을 지원합니다. 여기에는 프롬프트와 결과물이 모두 포함됩니다. 긴 컨텍스트는 더 많은 선불 크레딧을 소모합니다. 예상치 못한 과금을 피하려면 토큰 사용량을 모니터링하십시오.
입력 토큰은 백만 개당 $0.15입니다. 출력 토큰은 백만 개당 $0.50입니다. 출력 토큰이 훨씬 비쌉니다. 프롬프트를 최적화하여 입력 크기를 줄이세요. 간결한 시스템 지시문을 사용하세요. 불필요한 기록을 보내지 마세요.
출력 길이를 제어하기 위해 max_tokens 매개변수를 설정합니다. 기본값은 2,048 토큰입니다. 요청당 16,000 토큰까지 늘릴 수 있습니다. 이는 크레딧을 빠르게 소모하는 과도한 생성을 방지합니다.
에러와 거부는 무료입니다. 성공적인 토큰 생성에만 지불합니다. 이는 실패한 요청에 대한 낭비된 지출로부터 보호합니다. 현재 상태를 파악하려면 잔액을 정기적으로 추적하십시오.
가격 내역
- 입력: 토큰 1M당 $0.15
- 출력: $0.50 / 1M 토큰
- 최대 출력: 16,000 토큰
- 컨텍스트 창: 100,000 토큰
속도 제한 및 동시성 설정
각 API 키는 분당 300회 요청을 허용합니다. 이 제한은 키 전체에 전역적으로 적용됩니다. 고빈도 애플리케이션은 요청 속도를 신중하게 관리해야 합니다. 제한을 초과하면 429 Too Many Requests 오류가 반환됩니다.
키당 최대 8개의 동시 요청이 가능합니다. 이는 독립적인 작업의 병렬 처리를 허용합니다. 속도 제한에 도달하지 않도록 동시성을 관리하세요. 요청을 시간 간격에 걸쳐 분배하세요.
최대 요청 본문 크기는 8 MB입니다. 긴 기록이 포함된 큰 페이로드는 이 제한을 초과할 수 있습니다. 입력을 압축하거나 이전 메시지를 잘리십시오. 이는 요청이 성공적으로 처리되도록 보장합니다.
계정당 활성 키는 하나만 가질 수 있습니다. 키를 분실한 경우 새 키를 생성하세요. 이전 키는 즉시 무효화됩니다. 이는 보안 관리를 단순화합니다. 추가 보안을 위해 키를 주기적으로 교체하세요.
curl https://api.isgrokunfiltered.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Generate a list of five unique Python script ideas."}]
}'
기존 Grok API 키 마이그레이션
당사 API로의 마이그레이션에는 기본 URL과 모델 ID 변경이 필요합니다. 기존 클라이언트 코드 구조는 대부분 동일하게 유지됩니다. 기본 URL을 HTTPS://api.isgrokunfiltered.com/v1로 업데이트하세요. 모델 ID를 "uncensored"로 변경하세요.
일반적인 통합 오류トラブルシュー팅
401 Unauthorized 오류는 유효하지 않거나 만료된 API 키를 나타냅니다. 대시보드에서 키를 확인하세요. Authorization 헤더에 보내고 있는지 확인하세요. 선행 공백이나 오타가 있는지 확인하세요.
429 Too Many Requests는 속도 제한에 도달했음을 의미합니다. 요청 빈도를 줄이거나 호출 간격을 늘리세요. 재시도에 지수 백오프를 사용하세요. 이렇게 하면 서버에 과부하가 걸리는 것을 방지할 수 있습니다.
400 Bad Request는 종종 유효하지 않은 JSON에서 비롯됩니다. 페이로드가 예상 스키마와 일치하는지 확인하세요. messages 또는 model과 같은 필수 필드가 누락되지 않았는지 확인하세요. GET 엔드포인트를 사용하여 모델 가용성을 확인하세요.
500 Internal Server Errors는 드물지만 발생할 수 있습니다. 짧은 지연 후 요청을 재시도하세요. 문제가 지속되면 지원팀에 문의하세요. 로그를 통해 근본 원인을 빠르게 파악할 수 있습니다.
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)
다음 단계: uncensored 모델 테스트
간단한 텍스트 생성 요청으로 시작하세요. 짧은 프롬프트를 보내고 응답 형식을 검증하세요. 스트리밍이 올바르게 작동하는지 확인하세요. 함수 호출이 코드와 원활하게 통합되는지 확인하세요.
선불 모델은 실제 토큰에만 청구합니다. 오류는 무료이므로 안전한 실험이 가능합니다. 필요시 암호화폐로 크레딧을 충전하세요.
긴 컨텍스트와 복잡한 도구 정의와 같은 경계 사례를 테스트하세요. 무검열 모델이 다양한 주제를 처리하는지 확인하세요. 앱이 부분 응답을 올바르게 처리하는지 확인하세요. 이는 프로덕션 사용을 준비합니다.
구글 또는 이메일로 가입하세요. 즉시 API 키를 받으세요. 전화번호 불필요. $0.50 체험 크레딧으로 즉시 테스트를 시작하세요. 이는 서비스를 평가할 수 있는 리스크 없는 방법을 제공합니다.
자주 묻는 질문
이것이 공식 Grok API인가요?
아니요, 이는 독립형 서비스입니다. 우리는 Grok나 기타 벤더's 모델을 제공하지 않습니다. OpenAI API 사양과 호환되는 별도의 uncensored 대규모 언어 모델을 제공합니다. 기존 OpenAI 호환 클라이언트를 사용하여 서비스에 연결할 수 있습니다.
API는 어떻게 결제하나요?
암호화폐로만 충전되는 미리 충전된 크레딧 시스템을 사용합니다. TRC20 네트워크의 USDT 또는 Base 네트워크의 USDC로 지불할 수 있습니다. 최소 충전은 $20부터 시작합니다. 크레딧은 만료되지 않으며 실제로 사용한 토큰에만 지불합니다.
컨텍스트 윈도우 크기는 얼마인가요?
우리 모델은 100,000개의 토큰 컨텍스트 윈도우를 지원합니다. 이는 입력 프롬프트와 생성된 완성문을 모두 포함합니다. 요청당 최대 출력 토큰을 최대 16,000개까지 설정할 수 있습니다. 기본 최대 토큰 수는 2,048입니다.
모델은 콘텐츠를 거부하나요?
이 모델은 합법적인 성인 용도에 대해 검열되지 않습니다. 논쟁적인 주제, 픽션(가상), 보안 연구 주제를 거부하지 않습니다. 유일한 명확한 제한 사항은 미성년자를 대상으로 한 성 콘텐츠가 항상 거부된다는 것입니다. 숨겨진 기업용 필터 없이 원본 출력을 제공합니다.
API 키를 지금 받으세요
등록하고, 키를 복사한 후 기본 URL을 업데이트하세요. 필요한 설정은 여기까지입니다.