API 문서 & 시작하기

인증 및 Base URL

모든 요청은 클라이언트를 다음에 연결하여 시작하세요 HTTPS://api.uncensoredia.com/v1 키를 첨부하고 인증 표준 Bearer 스키마이므로 Google 또는 이메일로 가입 후 받은 토큰을 붙여넣기만 하면 됩니다. 엔드포인트는 완전히 openai compatible API 규정 준수, 기존 구성의 base URL과 API 키만 교체하면 됩니다. 복잡한 라우팅 레이어나 프록시 헤더를 관리할 필요가 없습니다. 다음을 확인하세요. Authorization header에는 고유한 토큰이 포함됩니다. 이 설정은 요청이 중간 필터링 없이 전용 무검열 모델에 도달함을 보장합니다. 만약 401 키가 활성화되어 있고 형식이 올바른지 확인하십시오.

채팅 완료 엔드포인트

다음으로 메시지 전송 POST /v1/chat/completions uncensored 모델로부터 텍스트 응답을 받습니다. 이 단일 엔드포인트는 간단한 프롬프트부터 복잡한 다중 턴 대화까지 모든 생성 작업을 처리합니다. 길이와 무작위성을 조절하기 위해 max_tokens, temperature, 그리고 top_p. 모델은 방대한 100,000 토큰 컨텍스트 창을 사용하여 방대한 문서나 긴 대화 기록을 제공할 수 있습니다. 응답으로 최대 16,000개의 토큰을 보낼 수 있습니다. 생략하면 max_tokens, 기본 제한은 2,048 토큰입니다. 이 엔드포인트는 이미지 또는 오디오 생성을 지원하지 않습니다. 텍스트 입력, 텍스트 출력만 지원합니다. 연결을 즉시 테스트하려면 다음 curl 명령을 사용하세요.

Python SDK 통합

공식 OpenAI Python 라이브러리를 사용하여 API와 최소한의 코드 변경으로 상호작용하세요. 다음을 재정의하기만 하면 됩니다. base_url 및 api_key 클라이언트 구성에서. 이 방법은 응답, 오류 및 재시도 처리를 위한 기존 로직이 유지되도록 보장합니다. 라이브러리는 활성화된 경우 JSON 직렬화 및 스트리밍을 자동으로 처리합니다. 이 방법은 대량의 텍스트를 처리해야 하는 백엔드 서비스나 스크립트에 이상적입니다. Uncensored 모델은 사용자 정의 구문 분석 로직 없이 표준 채팅 완료 요청에 응답합니다. 클라이언트를 한 번 구성하고 애플리케이션 전체에서 사용하십시오. 다음은 클라이언트 초기화 및 기본 요청 보내는 방법입니다.

Node.js SDK 설정

다음을 사용하여 JavaScript 또는 TypeScript 애플리케이션에 API를 통합하세요. @anthropic-ai/sdk 또는 공식 openai package. Set the baseURL 당사 엔드포인트로 설정하고 API 키를 제공하십시오. 이를 통해 다음 같은 익숙한 메서드를 사용할 수 있습니다. chat.completions.create() 직접적입니다. SDK가 HTTP 요청을 처리하고 JSON 응답을 구문 분석합니다. 다음과 같은 오류를 쉽게 처리할 수 있습니다. 402 (크레딧 부족) 또는 429 (rate limit)을 애플리케이션 로직 내에서 처리합니다. 이 설정은 웹 서버, 봇 또는 모든 Node.js 환경에 적합합니다. 무검열 모델은 표준 요청 형식과 원활하게 작동합니다. API의 기대 사항과 호환되도록 클라이언트를 구성하세요.

스트리밍 응답

다음 설정하여 실시간 토큰 전달 활성화 stream: true 요청에 포함됩니다. API는 텍스트가 생성되는 대로 표시할 수 있는 서버 전송 이벤트(SSE) 스트림을 반환합니다. 이는 채팅 인터페이스의 사용자 경험을 개선하고 지각된 지연 시간을 줄입니다. 각 청크에는 부분 응답이 포함되며, 마지막 청크에는 토큰 사용량 통계가 포함됩니다. 이러한 청크를 단계별로 처리하여 전체 응답을 구성할 수 있습니다. 즉각적인 피드백이 필요한 애플리케이션에 이 기능이 필수적입니다. uncensored 모델은 모든 요청 유형에 대한 스트리밍을 지원합니다. 스트림 이벤트를 처리하여 UI를 효율적으로 업데이트하세요. 클라이언트에서 스트리밍을 구현하려면 이 코드를 사용하세요.

속도 제한 및 컨텍스트 제한

API는 모든 사용자를 위한 안정적인 성능을 보장하기 위해 엄격한 제한을 적용합니다. 최대 분당 300회 요청 키당 및 보유 8 concurrent requests 언제나 활성화됩니다. 최대 요청 본문 크기는 8 MB입니다. 이 한도를 초과하면 429 상태 코드를 확인하세요. 이러한 제한에 반복적으로 도달하지 않도록 지수 백오프(exponential backoff)로 재시도 처리를 구현해야 합니다. 컨텍스트 윈도우는 100,000 토큰이지만 최대 출력은 16,000 토큰입니다. 더 많은 출력이 필요하면 max_tokens 파라미터. 401 (잘못된 키) 및 402 (크레딧 없음)은 즉시 발생하며 토큰 할당량을 소모하지 않습니다. 대용량 생성 작업 중 서비스 중단이 발생하지 않도록 할당량을 신중하게 관리하세요.

cURL

Copycurl https://api.uncensoredia.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "return json with key status true"}]
  }'

Python

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

스트리밍

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