Uncensored AI API 연동 방법

Uncensored AI API를 선택해야 하는 이유

대부분의 상용 LLM 제공업체는 창의적인 글쓰기, 역할극 또는 논쟁적인 주제에 대한 기술적 분석을 차단할 수 있는 강력한 안전 필터를 구현합니다. 무검열 AI API는 이러한 임의적인 거부를 제거하여 모델이 콘텐츠 정책 레이어가 아닌 학습 데이터를 기반으로 답변할 수 있도록 합니다. 이는 사후 처리 필터 없이 원본 모델 출력이 필요한 애플리케이션을 구축하는 개발자에게 특히 유용합니다.

여러 공급업체로 요청을 라우팅하는 모델 애그리게이터와 달리 이 서비스는 단일 전용 모델을 제공합니다. 이는 라우팅 로직의 예측 불가능성을 제거하고 요청 간 일관된 동작을 보장합니다. 이 모델은 합법적인 성인 콘텐츠, 보안 연구, 픽션 내러티브에 대한 거부를 최소화하도록 특별히 조정된 오픈 웨이트 모델입니다.

하지만 '무검열'이 무제한을 의미하는 것은 아닙니다. 이 서비스는 여전히 미성년자가 포함된 성적인 콘텐츠에 대해 하드 제한을 적용합니다. 성인 테마나 비전통적인 로직을 포함한 대부분의 기타 사용 사례의 경우, 모델은 응답을 생성합니다. 이 접근 방식은 제공업체의 취향에 의존하지 않고 애플리케이션의 콘텐츠 전략을 완전히 제어하려는 개발자에게 이상적입니다.

환경 설정

통합은 OpenAI 호환 SDK를 올바른 베이스 URL로 향하게 하는 것으로 시작됩니다. 엔드포인트는 https://api.uncensoredai.top/v1에서 호스팅됩니다. 이는 클라이언트 로직을 다시 작성하지 않고도 공식 OpenAI Python 또는 Node.js 라이브러리를 사용할 수 있음을 의미합니다. base_url 매개변수만 업데이트하고 API 키를 제공하면 됩니다.

이 서비스는 100,000개의 토큰 컨텍스트 창을 지원하며, 이는 많은 표준 제공 서비스보다 훨씬 큰 규모입니다. 이를 통해 광범위한 프롬프트 이력이나 대규모 문서 처리가 가능합니다. 요청당 최대 출력은 32,000개의 토큰으로 제한됩니다. max_tokens을 지정하지 않으면 기본값은 2,048개의 토큰입니다.

• SDK 호환성: OpenAI Chat Completions 프로토콜을 사용하는 모든 클라이언트와 작동합니다.
• 컨텍스트 창: 총 100k 토큰 (입력 + 출력).
• 최대 출력: 요청당 16k 토큰.

지연 시간 문제를 피하기 위해 환경 변수가 올바르게 설정되었는지 확인하십시오. 이 API는 직접적인 코드 중심 통합을 위해 설계되었으므로 학습할 웹 인터페이스가 없습니다. HTTP 요청을 통해서만 상호 작용합니다.

인증 및 헤더

인증은 표준 Authorization 헤더를 통해 처리됩니다. 가입 시 단일 API 키를 받게 됩니다. 하나의 계정에 여러 키를 발급하는 서비스와 달리, 이 플랫폼은 하나의 계정에 활성 키 하나만 적용합니다. 새 키를 생성하면 이전 키는 즉시 무효화됩니다.

요청을 인증하려면 다음 헤더를 포함하세요: Authorization: Bearer YOUR_API_KEY. 서비스는 사용 가능한 모델 정보와 모델 ID uncensored를 반환하는 GET /v1/models 엔드포인트도 제공합니다. 이는 복잡한 페이로드를 보내기 전에 연결을 확인하는 데 유용합니다.

속도 제한:

• 키당 분당 300회 요청.
• 키당 동시에 8회 요청.
• 최대 요청 본문 크기 8 MB.

이러한 제한은 대부분의 애플리케이션에 관대하지만 429 오류를 피하기 위해 준수해야 합니다. 구독 티어가 없으므로 이러한 제한은 크레딧 잔액에 관계없이 모든 사용자에게 균일하게 적용됩니다.

첫 번째 생성 요청 보내기

기본 요청은 표준 Chat Completions 형식을 따릅니다. model을 uncensored로 설정하고 messages 배열을 보내면 됩니다. 서비스는 텍스트 응답을 반환합니다. 임베딩, 비전, 오디오 엔드포인트가 없으며 순수 텍스트 API입니다.

요청 예시:

다음은 표준 채팅 생성의 예시입니다. YOUR_API_KEY을 실제 키로 바꾸십시오.

Copycurl https://api.uncensoredai.top/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."}]
  }'

응답에는 choices[0].message.content에 생성된 텍스트가 포함됩니다. 오류는 표준 HTTP 형식으로 반환되므로 재시도 또는 실패를 정상적으로 처리할 수 있습니다. 오류는 크레딧을 소모하지 않으므로 자유롭게 테스트할 수 있습니다.

OpenAI에 익숙한 개발자에게 경험은 동일합니다. 유일한 차이점은 베이스 URL과 콘텐츠 필터에 대한 모델의 동작입니다. 이 일관성은 이미 OpenAI 호환 도구를 사용하는 팀의 학습 곡선을 줄여줍니다.

스트리밍 응답 처리

스트리밍은 서버 전송 이벤트(SSE)를 통해 지원됩니다. 이를 통해 생성되는 토큰을 수신하여 긴 응답에 대한 사용자 경험을 개선할 수 있습니다. 스트리밍 엔드포인트는 비스트리밍 엔드포인트와 동일하며 요청에 stream: true을 설정하기만 하면 됩니다.

스트리밍의 장점:

• 사용자의 지각된 지연 시간 감소.
• 실시간으로 부분 결과 표시 가능.
• 토큰이 증분 처리되므로 메모리 사용 효율성.

스트리밍 응답의 마지막 청크에는 토큰 사용량 통계가 포함됩니다. 이는 정확히 몇 개의 토큰이 소모되었는지 추적할 수 있으므로 청구 정확도에 중요합니다. 스트리밍 중 오류가 발생하면 부분적인 응답이 반환될 수 있으므로 클라이언트는 불완전한 청크를 정상적으로 처리해야 합니다.

코드 예시:

Copyfrom openai import OpenAI

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

클라이언트 라이브러리가 SSE 스트림을 올바르게 처리하는지 확인하세요. 대부분의 최신 SDK는 이를 추상화하지만 기본 프로토콜을 이해하면 연결 문제나 구문 분석 오류를 디버깅하는 데 도움이 됩니다.

고급 기능: JSON 모드 및 도구

API는 response_format을 {"type": "json_object"}로 설정하여 구조화된 출력을 지원합니다. 이는 모델이 유효한 JSON을 반환하도록 강제하며, 다른 소프트웨어 시스템과 통합하는 데 필수적입니다. 이 기능은 데이터 추출이나 구성 파일 생성에 특히 유용합니다.

함수 호출도 지원됩니다. 요청에 도구를 정의하면 모델이 응답에서 도구 호출을 반환합니다. 이를 통해 LLM이 외부 작업을 트리거할 수 있는 복잡한 워크플로우를 구현할 수 있습니다. tool_choice 매개변수를 사용하여 특정 도구를 강제하거나 모델이 결정하도록 할 수 있습니다.

주요 매개변수:

• temperature: 무작위성을 제어합니다.
• top_p: 다양성을 제어합니다.
• stop: 중지 시퀀스를 정의합니다.
• seed: 결정론적 응답을 위해.

이러한 기능은 신뢰할 수 있는 구조화된 데이터가 필요한 프로덕션 애플리케이션에 API를 적합하게 만듭니다. 모델은 무검열이지만 요청 시 구조적 제약 조건을 여전히 준수합니다. 이 자유와 구조의 균형은 복잡한 에이전트를 구축하는 개발자에게 주요 이점입니다.

사용량 및 제한 모니터링

사용량은 API 키별로 추적됩니다. 대시보드에서는 현재 선불 크레딧 잔액과 최근 요청 내역을 확인할 수 있습니다. 청구가 실제 토큰 사용량을 기반으로 하므로 비용을 실시간으로 모니터링할 수 있습니다. 서비스는 오류나 거부에 대해 요금을 부과하지 않으므로 테스트 단계에서 비용을 절약할 수 있습니다.

사용량 지표:

• 입력 토큰: 토큰 100만 개당 $0.25.
• 출력 토큰: 토큰 100만 개당 $1.00.
• 오류: 무료.

클라이언트 라이브러리에서 지원한다면 알림을 설정할 수 있지만, 주요 모니터링은 계정 대시보드에서 수행됩니다. 분당 300회의 요청 제한은 모든 사용자에게 공정한 사용을 보장합니다. 이 제한을 초과하면 429 상태 코드를 받게 됩니다.

대규모 애플리케이션의 경우 재시도에 지수 백오프를 구현하는 것을 고려하십시오. 서비스는 신뢰할 수 있도록 설계되었지만 네트워크 문제나 속도 제한이 발생할 수 있습니다. 토큰 사용량을 추적하면 크레딧이 만료되지 않기 때문에 예산을 효과적으로 관리하는 데 도움이 됩니다.

암호화폐를 통한 크레딧 관리

결제는 암호화폐로만 처리됩니다. USDT(TRC20) 또는 USDC(Base)로 계정을 충전할 수 있습니다. 최소 충전 금액은 $10이며 최대 금액은 $500입니다. 월 구독료나 반복 요금이 없습니다.

보너스 크레딧:

• $50 충전: +5% 보너스 크레딧.
• $100 충전: +10% 보너스 크레딧.

크레딧은 만료되지 않으므로 한 번 충전하여 시간이 지남에 따라 사용할 수 있습니다. 이는 토큰 소비량이 변동하는 장기 프로젝트에 이상적입니다. 신용 카드 처리 수수료가 없다는 점은 이미 스테이블코인을 보유한 개발자에게 암호화폐를 비용 효율적인 옵션으로 만듭니다.

결제 프로세스:

Copyimport OpenAI from "openai";

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

지불하려면 대시보드에서 입금 주소를 생성하고 암호화폐를 전송하면 크레딧이 자동으로 추가됩니다. 크레딧에 대한 환불은 제공되지 않지만, 중복 청구와 같은 오류는 지원 페이지를 통해 해결됩니다. 이 모델은 은행 제한으로 인해 어려움을 겪을 수 있는 글로벌 개발자에게 편의성을 제공합니다.