무검열 Gemma: 개발자를 위한 통합 가이드

무검열 Gemma를 선택해야 하는 이유?

개발자들이 무검열 gemma 스타일의 경험을 원할 때, 상업용 제품에서 흔히 볼 수 있는 안전 필터를 피하는 모델을 찾는 경우가 많습니다. 이 API는 합법적인 성인용, 보안 연구, 논쟁적인 주제에 대해 콘텐츠 거부 없이 답변하도록 조정된 단일 고용량 모델을 제공합니다. 여러 벤더를 집계하는 플랫폼과 달리 이 서비스는 하나의 특정 오픈 웨이트 모델에 집중하여 일관된 동작과 예측 가능한 지연 시간을 보장합니다.

이 모델은 표준 창의적이거나 분석적인 프롬프트를 거부하지 않으므로 다양한 콘텐츠 스타일 생성에 적합합니다. 그러나 이는 독립적인 오픈 웨이트 모델이며 Google의 Gemma가 아니며 xAI의 Grok와도 관련이 없다는 점에 유의해야 합니다. 전용 서버에서 실행되며 텍스트 입력과 텍스트 출력을 제공하여 라우팅 오버헤드 없이 원본 모델 출력이 필요한 개발자에게 깨끗하고 예측 가능한 환경을 제공합니다.

API 호환성 개요

API는 완전히 OpenAI 호환이므로 공식 OpenAI SDK나 OpenAI 프로토콜을 사용하는 다른 클라이언트를 사용할 수 있습니다. base_url만 업데이트하고 API 키를 제공하면 됩니다. 엔드포인트 구조는 표준 채팅 완료 인터페이스를 반영하여 다른 제공업체에서 마이그레이션하는 것이 매우 쉽습니다.

• 엔드포인트: POST /v1/chat/completions 및 GET /v1/models만 사용할 수 있습니다.
• 추가 기능 없음: 임베딩, 이미지 생성, 오디오 처리 또는 파인튜닝 엔드포인트가 없습니다.
• 기본 URL: https://api.grokuncensored.cc/v1
• 모델 ID: 모델 식별자로 uncensored를 사용하세요.

이러한 단순성은 통합 복잡성을 줄입니다. 다양한 기능에 대해 다른 응답 스키마를 처리할 필요가 없습니다. 응답 형식은 일관되며 텍스트 콘텐츠와 토큰 사용 통계를 반환합니다.

환경 설정

통합은 API 키를 획득하는 것으로 시작됩니다. Google 인증 또는 이메일과 비밀번호를 사용하여 API 키 받기 페이지에서 가입하세요. 키는 즉시 표시되며 전화번호가 필요하지 않습니다. 이 프로세스는 속도를 위해 설계되었으며 몇 분 안에 테스트를 시작할 수 있습니다.

키를 얻은 후 환경 변수를 구성하세요. 예를 들어 Python에서는 다음과 같습니다:

베이스 URL이 https://api.grokuncensored.cc/v1를 가리키는지 확인하세요. 또한 7일 동안 유효한 $0.50의 무료 체험 크레딧을 활용할 수 있으며, 신용카드가 필요 없습니다. 이를 통해 암호화폐 충전 전에 연결성 및 응답 품질을 확인할 수 있습니다.

첫 번째 요청 보내기

환경이 구성되면 요청을 보낼 수 있습니다. API는 표준 메시지 배열을 받습니다. 다음은 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."}]
  }'

응답에는 생성된 텍스트와 토큰 사용량이 포함됩니다. max_tokens에 값을 설정하면 API는 해당 제한을 준수합니다. max_tokens을 설정하지 않으면 기본 최대 출력은 2,048 토큰입니다. 더 긴 출력이 필요한 경우 전체 컨텍스트(프롬프트 + 완성)가 100,000 토큰 창 내에 머무는 한 최대 32,000 토큰까지 늘릴 수 있습니다.

응답 및 토큰 처리

응답은 표준 JSON 형식으로 반환됩니다. 토큰 사용량은 스트리밍 응답의 마지막 청크에 포함되어 실시간으로 비용을 추적할 수 있습니다. 가격은 투명합니다: 입력 토큰 1M당 $0.25 및 출력 토큰 1M당 $1.00. 오류와 거부는 무료이므로 크레딧 낭비에 대한 걱정 없이 실험할 수 있습니다.

스트리밍을 사용할 때 클라이언트가 서버 전송 이벤트(SSE)를 올바르게 처리하는지 확인하세요. API는 텍스트 청크를 반환하며 마지막 청크에는 usage 필드가 포함됩니다. 이를 통해 정확한 청구 조정이 가능합니다. 크레딧은 선불이며 오류는 잔액에서 차감되지 않습니다. 이 모델은 임베딩 서비스가 아니므로 직접 벡터 검색에 사용할 수 없으며 필요시 임베딩을 별도로 처리해야 합니다.

고급 매개변수

API는 생성 품질을 제어하기 위해 여러 매개변수를 지원합니다. 창의성을 위해 temperature, 뉴클레어스 샘플링을 위해 top_p, 재현성을 위해 seed을 조정할 수 있습니다. 기타 지원 매개변수에는 stop, presence_penalty 및 frequency_penalty이 포함됩니다.

함수 호출은 tools 및 tool_choice 필드를 통해 지원됩니다. 이를 통해 모델이 애플리케이션에서 구문 분석할 수 있는 구조화된 출력을 생성할 수 있습니다. 또한 response_format: {"type": "json_object"}을 통해 JSON 모드를 사용할 수 있어 출력이 유효한 JSON임을 보장합니다. 이는 에이전트 구축 또는 구조화된 데이터 파이프라인에 유용합니다. 이 모델은 고품질 텍스트 생성을 위해 조정된 오픈 웨이트 모델로, 복잡한 지시 따르기에 적합합니다.

오류 처리

오류는 표준 HTTP 상태 코드로 반환됩니다. 일반적인 오류에는 속도 제한(429) 또는 잘못된 API 키(401)가 포함됩니다. 속도 제한은 분당 300개 요청 및 키당 8개의 동시 요청으로 설정됩니다. 이러한 제한에 도달하면 클라이언트에서 지수 백오프를 구현하세요.

요청 본문의 크기는 8 MB로 제한됩니다. 이를 초과하면 요청이 거부됩니다. 프롬프트가 이 범위 내에 있는지 확인하세요. API가 텍스트 전용이므로 미디어 처리 관련 오류는 발생하지 않습니다. 잔액 부족과 같은 청구 오류의 경우 API는 402 상태 코드를 반환합니다. 크레딧은 만료되지 않으므로 편리할 때 충전할 수 있습니다. 중복 청구 같은 오류는 크레딧이 자동으로 환불되지 않으므로 지원 페이지를 통해 해결할 수 있습니다.

Grok 무검열과의 비교

grok uncensored 등 다른 무검열 모델과 함께 종종 논의되지만, 이 API는 독립적인 서비스입니다. Google의 Gemma를 제공하지 않으며 xAI의 공식 Grok API도 아닙니다. 검색 결과의 uncensored gemma 용어는 주로 오픈 웨이트 모델의 동작을 지칭하며, 이 API는 이를 밀접하게 모방합니다. 그러나 모델 ID는 단순히 uncensored이며 Google의 아키텍처와 관련이 없습니다.

가격과 제한이 다를 수 있는 공식 Grok API와 달리, 이 API는 백만 토큰당 $0.25/$1.00의 고정 요금을 제공합니다. 또한 암호화폐 결제만 지원하며, 무료 체험에는 신용카드가 필요 없습니다. 이는 암호화폐를 선호하거나 구독 잠금에서 벗어나고자 하는 개발자에게 유연한 대안이 됩니다. 이 모델은 Grok의 리셀러가 아니며, 별도의 오픈 웨이트 모델입니다.

결론

이 API는 무검열 오픈 웨이트 모델을 위한 견고한 개발자 중심 인터페이스를 제공합니다. OpenAI 호환 프로토콜을 고수함으로써 기존 워크플로우에 원활하게 통합됩니다. 가격은 투명하며 제한은 대부분의 사용 사례에 관대합니다. 채팅봇, 에이전트 또는 콘텐츠 생성 도구를 구축하든 이 API는 신뢰할 수 있는 무검열 대안을 제공합니다. 텍스트 전용 API이므로 아키텍처를 그에 따라 계획하세요. 가격 및 키에 대한 자세한 내용은 사이트의 해당 페이지를 방문하세요.