무검열 API 빠른 시작 가이드

설치 및 필요 라이브러리

무검열 API는 OpenAI SDK 및 클라이언트와 직접 호환되도록 설계되었습니다. 통합 설치를 위해 할 일은 기존 코드에서 base_url 값을 https://api.sansursuzapi.com/v1로 설정하고 API 키를 구성하는 것뿐입니다. 사용 중인 언어에 적합한 SDK 패키지를 설치하면 되며, 추가 서버 구성이나 복잡한 인증 메커니즘이 필요하지 않습니다. 시스템은 표준 Bearer 토큰 인증을 사용하며 키를 요청 헤더에 직접 전달합니다.

기본 요청 예시

API 사용을 시작하려면 간단한 POST 요청을 보내면 텍스트 생성을 트리거할 수 있습니다. 아래 예시는 curl을 통해 uncensored 모델에 접근하는 방법을 보여줍니다. 요청 본문에는 모델 이름, 사용자 메시지, 응답 형식이 명시됩니다. 이 구조는 OpenAI의 표준 chat-completions 스키마를 따릅니다.

Kopyalacurl https://api.sansursuzapi.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."}]
  }'

이 요청은 모델의 무검열 동작을 테스트하기 위한 이상적인 시작점입니다. 응답으로 반환되는 JSON 객체에는 생성된 텍스트와 토큰 통계가 포함됩니다. 빠른 테스트에는 이 간단한 구조를 사용하고, 프로젝트 요구 사항에 따라 매개변수를 사용자 정의할 수 있습니다.

스트리밍 및 함수 호출

대규모 텍스트 블록이나 긴 대화 기록 시나리오의 경우 스트리밍 모드를 사용할 수 있습니다. 이 모드는 서버에서 오는 데이터를 청크 단위로 처리하여 사용자 경험을 향상시킵니다. 또한 모델이 외부 도구와 상호작용할 수 있게 하는 함수 호출 기능도 지원됩니다. 이 기능은 모델이 특정 JSON 스키마에 따라 데이터를 반환하고 해당 데이터를 애플리케이션에서 처리할 수 있게 합니다.

Kopyalafrom openai import OpenAI

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

Kopyalaimport OpenAI from "openai";

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

Python 및 Node.js SDK는 이러한 스트리밍 및 함수 구조를 관리하기 위한 필요한 도구를 제공합니다. 선택적으로 stream: true 매개변수로 응답을 청크 단위로 받거나 tools 구조를 사용하여 모델의 데이터 생성을 구성할 수 있습니다.

모델 목록 및 호환성

API는 현재 단일 대형 언어 모델을 제공합니다: uncensored. 이 모델은 특별히 조정된 오픈 웨이트 모델 구조를 가지며, 일반 모델에서 발견되는 인위적 필터링을 제거하도록 최적화되었습니다. 모델 목록 엔드포인트(GET /v1/models)를 통해 현재 모델을 확인할 수 있습니다. 이 모델은 OpenAI의 GPT, Claude, Gemini 또는 Grok 시리즈와 무관하게 당사 GPU 서버에서 실행됩니다. 이 호환성으로 기존 OpenAI 클라이언트를 바로 사용할 수 있습니다.

오류 코드 및 제한

API 사용 중 발생할 수 있는 주요 상태 코드는 다음과 같습니다: 401 유효하지 않거나 누락된 API 키, 402 충분한 크레딧 부재, 429 분당 300개 요청 속도 제한 초과. 각 계정에는 하나의 API 키만 유효하며, 키가 갱신되면 이전 키가 비활성화됩니다. 요청 본문은 8 MB를 초과하지 않아야 합니다. 컨텍스트 창은 100,000 토큰으로 제한됩니다. 이는 프롬프트와 완성 텍스트 모두를 합한 총 토큰 수를 의미합니다. 이러한 제한은 API의 안정적 운영에 중요합니다.

가격 및 크레딧 관리

무검열 API는 종량제 모델로 동작합니다. 입력 토큰은 토큰 100만 개당 $0.25, 출력 토큰은 토큰 100만 개당 $1.00에 청구됩니다. 충전한 크레딧은 만료되지 않으며 구독료가 없습니다. 신규 계정은 신용카드 없이 7일 동안 유효한 $0.50 무료 체험 크레딧을 받습니다. 크레딧이 부족해져도 서비스가 중단되지 않으며, 새로운 요청을 위해만 크레딧을 충전하면 됩니다. 총 +5% 보너스는 $50 충전 시, +10% 보너스는 $100 충전 시 적용됩니다.

스트리밍

Kopyalastream = 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)