Uncensored Endpoint: Base URL, 모델 ID 및 제한 사항
여기의 uncensored 엔드포인트는 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하는 호스팅된 OpenAI 호환 텍스트 API를 의미합니다. 이 페이지에는 코드 작성 전에 필요한 정확한 기본 URL, 모델 ID, 메서드, 제한 사항 및 오류 코드가 나열되어 있습니다.
주요 포인트
- 베이스 URL은 https://api.uncensoredendpoint.com/v1이며 유일한 모델 ID는 uncensored입니다.
- 두 가지 메서드를 사용할 수 있습니다: POST /v1/chat/completions 및 GET /v1/models.
- 컨텍스트 창은 프롬프트와 완성을 합쳐서 100,000개의 토큰입니다.
- 전체 키는 8개의 동시 요청 및 분당 300개의 요청을 허용합니다.

연결 설정 요약
값만 필요하시다면 여기 있습니다. 이 페이지의 나머지 내용은 실제 작동 방식을 설명합니다.
| 설정 | 내용 |
|---|---|
| 기본 URL | https://api.uncensoredendpoint.com/v1 |
| 모델 ID | uncensored |
| 인증 헤더 | Authorization: Bearer YOUR_KEY |
| 엔드포인트 | POST /v1/chat/completions, GET /v1/models |
| 컨텍스트 창 | 100,000 토큰, 프롬프트 및 완성 포함 |
| 최대 요청 본문 | 8 MB |
| 전체 키 제한 | 동시 요청 8개, 분당 요청 300개 |
| 체험 키 제한 사항 | 동시 요청 2개, 분당 요청 60개 |
| 가격 | 입력 토큰 100만 개당 $0.15, 출력 토큰 100만 개당 $0.50 |
이 서비스는 OpenAI 채팅 완료 API와 동일한 전송 형식을 사용합니다. 사용자 정의 기본 URL과 API 키를 입력할 수 있는 도구를 사용한다면 이 서비스에 연결할 수 있습니다. API 키는 API 키 페이지에서 발급받으세요. 문서에는 동일한 참조 정보가 더 짧은 형태로 제공됩니다.
각 메서드의 역할
라우트가 두 개뿐이어서 공격 표면이 작게 유지됩니다.
GET /v1/models은 모델 목록을 반환합니다.uncensored항목이 하나 표시됩니다. 많은 클라이언트가 이 라우트를 호출하여 모델 드롭다운을 채우므로, 키와 URL이 올바른지 빠르게 확인할 수 있습니다.POST /v1/chat/completions이 핵심 엔드포인트입니다. 메시지 목록을 받아 하나의 JSON 응답 또는 서버 전송 이벤트 스트림으로 완성 결과를 반환합니다.
이전 텍스트 완료 라우트, 응답 라우트, 임베딩, 이미지 라우트 및 오디오 라우트는 제품에 포함되지 않았습니다. 라이브러리에서 이러한 라우트를 시도하면 오류가 발생하므로 라이브러리를 채팅 모드로 전환하세요.
터미널에서 빠르게 확인:
curl https://api.uncensoredendpoint.com/v1/models \
-H "Authorization: Bearer $API_KEY"
uncensored가 포함된 JSON 목록은 키가 유효함을 의미합니다. HTTP 401은 키가 누락되었거나 입력 실수가 있거나 키에 불필요한 공백이나 줄바꿈이 포함되어 있음을 의미하며, 이는 키가 셸 변수에서 가져온 경우 가장 흔한 원인입니다.
curl, Python, Node.js로 첫 요청 보내기
세 예제 모두 동일한 데이터를 전송합니다: 시스템 메시지 하나, 사용자 메시지 하나, 낮은 temperature 설정. YOUR_KEY를 교체하거나 API_KEY 환경 변수를 설정하세요.
curl https://api.uncensoredendpoint.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."}
],
"temperature": 0.7
}'
공식 Python SDK를 사용할 때는 클라이언트에 두 가지 추가 인자만 전달하면 됩니다:
from openai import OpenAI
client = OpenAI(
base_url="https://api.uncensoredendpoint.com/v1",
api_key="YOUR_KEY",
)
resp = client.chat.completions.create(
model="uncensored",
messages=[
{"role": "system", "content": "You are a concise assistant."},
{"role": "user", "content": "Explain what a context window is in two sentences."},
],
temperature=0.7,
)
print(resp.choices[0].message.content)
print(resp.usage)
동일한 SDK를 사용한 Node.js 예제:
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.uncensoredendpoint.com/v1",
apiKey: process.env.API_KEY,
});
const resp = await client.chat.completions.create({
model: "uncensored",
messages: [
{ role: "system", content: "You are a concise assistant." },
{ role: "user", content: "Explain what a context window is in two sentences." },
],
});
console.log(resp.choices[0].message.content);
응답에는 프롬프트 및 완성 토큰 수가 포함된 usage 객체가 포함됩니다. 이를 주의 깊게 확인하세요: 이 두 숫자가 과금의 기준이 됩니다. 응답 헤더에는 X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests 및 X-RateLimit-Limit-Concurrency도 포함되어 있습니다. 이상 징후가 보일 경우 지원팀이 가장 먼저 요청할 것이므로 모든 호출 시 요청 ID를 로그에 기록하세요.
스트리밍, 함수 호출 및 JSON 모드
세 가지 기능이 대부분의 실제 애플리케이션을 커버하며, 모두 이미 알고 계실 OpenAI 형식을 따릅니다.
스트리밍
stream: true를 설정하고 서버 전송 이벤트를 읽으세요. 사용량은 스트림의 끝에 보고되므로 두 번째 요청 없이도 토큰을 세울 수 있습니다. 용량 계획에 중요한 한 가지 세부 사항은 스트리밍 요청이 스트림이 완료될 때까지 동시성 슬롯을 유지한다는 것입니다. 긴 응답을 느린 속도로 계속 읽는 느린 클라이언트는 전체 시간 동안 슬롯을 점유합니다.
stream = client.chat.completions.create(
model="uncensored",
messages=[{"role": "user", "content": "Write a four-line poem about rain."}],
stream=True,
)
for chunk in stream:
if chunk.choices and chunk.choices[0].delta.content:
print(chunk.choices[0].delta.content, end="", flush=True)
함수 호출
tools를 전달하고 선택적으로 tool_choice를 설정하세요. 모델이 함수 호출을 결정하면 응답에 tool_calls이 포함됩니다(스트리밍 모드에서도). 함수를 직접 실행한 후 결과를 role: "tool" 메시지로 다시 전송합니다. 이 모델은 단일 오픈 웨이트 모델이므로 실제 프롬프트로 도구 스키마를 테스트하고 매개변수 설명을 간결하고 구체적으로 유지하세요.
JSON 모드
response_format: {"type":"json_object"}를 전송하여 유효한 JSON 출력을 요청하세요. 프롬프트에서 JSON을 원한다는 것과 기대하는 필드를 명시적으로 설명하세요. 그래도 방어적으로 파싱하고, 출력에 맹목적으로 의존하기보다 파싱 실패 시 한 번만 재시도하세요.
샘플링 제어 인자는 그대로 전달됩니다: temperature, top_p, stop, seed 및 빈도 페널티와 존재 페널티.
실제 상황에서의 100,000 토큰 컨텍스트 창
컨텍스트 창은 100,000 토큰이며, 이 숫자는 프롬프트와 완성을 합친 것입니다. 완성은 프롬프트가 남긴 여유를 모두 사용할 수 있으며, max_tokens은 선택 사항입니다. 프롬프트로 90,000 토큰을 보내면 답변에 최대 약 10,000개만 남습니다.
영어 텍스트의 대략적인 규칙은 토큰 하나당 단어 한 개보다 약간 적게 나온다는 것입니다. 따라서 100,000 토큰은 약 70,000 단어에 해당합니다. 이는 긴 원고 한 분량, 코드베이스의 큰 부분 또는 수 시간치의 채팅 기록에 충분합니다. 이 컨텍스트 창을 유용하게 사용하려면 세 가지 습관이 필요합니다:
- 의도적으로 기록을 정리하세요. 채팅 클라이언트는 매 턴마다 전체 대화 내용을 다시 전송하므로 비용과 지연 시간이 증가합니다. 시스템 프롬프트, 이전 대화의 요약 및 마지막 몇 개 메시지만 유지하세요.
- 출력 크기가 중요할 때는
max_tokens을 설정하세요. 선택 사항이지만, 긴 프롬프트에서 응답이 폭주하는 것을 방지합니다. - 8 MB 본문 제한을 주의하세요. 이는 토큰 창과 별개입니다. 일반 텍스트는 8 MB에 도달하기 어렵지만, 프롬프트에 붙여넣은 base64 데이터는 이를 초과할 수 있습니다.
청구가 토큰 단위로 이루어지므로 전체 창을 사용하는 요청은 짧은 요청에 비해 실제 비용이 듭니다. 가격 책정 페이지에 요금이 나와 있으며, 모든 요청의 비용은 (입력 토큰 수 × $0.15 + 출력 토큰 수 × $0.50) / 1,000,000로 계산할 수 있습니다.
속도 제한 및 429 오류군
전체 키는 분당 300회 요청과 동시에 8회 요청을 허용합니다. 체험용 키는 더 제한적입니다: 동시에 2회, 분당 60회. 제한을 초과하면 API가 HTTP 429를 반환하며 오류 코드로 어떤 제한을 초과했는지 알려줍니다:
| 오류 코드 | 의미 | 대응 방법 |
|---|---|---|
rate_limited | 분당 요청 수 초과 | 요청 속도를 줄이고 분당 요청을 분산하세요. |
concurrency | 동시 요청 수가 초과되었습니다 | 클라이언트 측에서 큐를 사용하세요. 동시 작업자 수를 8로 제한하세요(체험용 키는 2). |
429 및 Retry-After: 5 | 일시적 과부하 | 5초를 기다린 후 다시 시도하십시오 |
가장 간단한 방어책은 자체 코드에 키 크기에 맞춘 세마포어를 두는 것입니다. Python의 asyncio를 사용할 경우, 각 호출에 asyncio.Semaphore(8)을 적용하면 concurrency 오류를 완전히 제거할 수 있습니다. Retry-After 헤더를 따르고 헤더가 없을 때 짧은 지수 백오프로 전환하는 재시도 로직을 추가하세요. 스트림은 전체 길이 동안 슬롯을 점유하므로, 8개의 긴 스트림이 있으면 분당 요청 수가 낮더라도 아홉 번째 요청이 차단될 수 있습니다.
실패하거나 거부된 요청은 청구되지 않으므로 재시도 루프가 실패한 시도만큼 비용이 들지 않습니다.
모델의 정체와 한계
이 서비스는 독립적인 제공자가 호스팅하고 콘텐츠 거부 없이 합법적인 성인 사용에 답변하도록 조정된 단일 오픈 웨이트 모델을 실행합니다. 이는 대형 벤더의 공식 API가 아니며, 벤더 간 라우터도 아닙니다. 단일 모델 uncensored만 있으므로 선택할 항목이 없으며 비교할 가격 등급도 없습니다.
제한 사항은 명확합니다. 텍스트가 입력되고 텍스트가 출력됩니다. 이미지, 오디오 또는 비디오 생성, 임베딩, 파인튜닝은 없습니다. 유일한 고정 콘텐츠 규칙은 미성년자가 포함된 성적인 콘텐츠가 절대 허용되지 않는다는 것입니다. 프롬프트는 학습에 사용되지 않습니다.
이러한 프레임워크는 프로젝트 계획을 세울 때 도움이 됩니다. 성인을 위한 픽션 및 역할극 도구, 컴패니언 앱, 모델 행동 연구, 모델이 물러서지 않고 직설적이거나 민감한 텍스트를 처리하는 도구 등이 모두 자연스러운 적합 대상입니다. 검색용 임베딩이 필요하면 해당 부분은 별도 제공자가 필요하지만 생성에는 이 엔드포인트를 계속 사용할 수 있습니다.
프로덕션 배포 전 확인 사항
작동하는 데모는 5분 정도면 충분합니다. 신뢰할 수 있는 서비스는 조금 더 걸립니다. 무료 체험 크레딧으로 시작하세요: 신규 사용자는 가입 후 키 페이지에서 클릭 한 번으로 $0.50의 크레딧을 청구할 수 있습니다. 이 크레딧은 1인당 한 번만 유효하며 7일 동안 유효하고 결제 정보가 필요하지 않습니다. 회원가입은 Google 또는 이메일과 비밀번호로 가능합니다. 이는 통합을 확인하기 위한 짧은 테스트 호출 수백 건에 충분합니다.
실제 트래픽으로 이동할 때는 $20에서 $500 사이의 정수 금액으로 선불 크레딧을 충전하세요. 결제는 암호화폐(USDT(TRC20), USDC(Base))로 가능합니다. 선불 크레딧은 만료되지 않으며 구독도 없으므로 잔액은 지출할 때까지 그대로 유지됩니다. 보너스는 $50부터 5%, $100부터 10%, $200부터 15%입니다.
그런 다음 짧은 목록을 따라 작업하세요: 키를 환경 변수나 비밀 관리자에 저장하고 클라이언트 측 코드에는 저장하지 마세요; X-Request-Id를 로그에 기록하세요; 잔액이 고갈되기 전에 경고할 수 있도록 X-Balance-USD을 모니터링하세요; 동시 작업자에 제한을 두세요; 그리고 빠른 루프가 아닌 지연을 사용하여 429 오류를 처리하세요. API 키에 대한 프로덕션 체크리스트는 키 처리를 더 자세히 다루며, 문서에는 매개변수 참조가 있습니다.
더 많은 가이드
질문과 답변
특별한 SDK가 필요한가요?
아니요. 모든 OpenAI SDK 또는 클라이언트가 작동합니다. Base URL과 키를 변경하고 모델을 uncensored로 설정하면 나머지 코드는 그대로 유지됩니다.
이미지나 임베딩을 생성할 수 있나요?
아니요. API는 텍스트 전용입니다. 이미지, 오디오, 비디오 생성, 임베딩, 파인튜닝이 없습니다.
속도 제한에 도달하면 어떻게 되나요?
HTTP 429이 반환됩니다. 분당 요청 수를 초과하면 오류 코드는 rate_limited이고, 동시 요청이 너무 많으면 concurrency입니다. 잠시 후 다시 시도하세요.
강력한 콘텐츠 규칙이 있나요?
네. 미성년자를 대상으로 한 성적인 콘텐츠는 절대 허용되지 않습니다. 그 외의 모든 콘텐츠는 법적 성인 사용 목적에 따라 거절 없이 응답하도록 모델이 조정되었습니다.
키는 양식 하나만 작성하면 받을 수 있습니다
계정을 생성하고 키를 복사한 후 기본 URL을 변경하세요. 설정은 이것으로 끝입니다.