Uncensored AI API 문서
더 큰 워크플로우를 연결하기 전에 짧은 요청 하나를 보내보세요. 이 가이드에서는 base URL, Bearer 인증 및 Chat Completions 요청 본문, 이어지는 스트리밍 및 오류 처리 방법을 보여줍니다. 예시를 실행하기 전에 계정에 사용 가능한 크레딧이 있는지 확인하세요.
- 입력 토큰 1M당
- $0.15
- 출력 토큰 / 1M
- $0.50
- 토큰 컨텍스트
- 100,000
- 체험 크레딧
- $0.50
- 분당 요청
- 300
베이스 URL 및 인증
base URL이 https://api.uncensoredaiapis.com/v1인 이 독립적인 텍스트 전용 Chat Completions 엔드포인트를 사용하세요. 현재 API 키를 Authorization 헤더에 보내야 합니다. 이 서비스는 하나의 모델 ID를 노출합니다. 통합하기 전에 출력, 오류 및 토큰 사용량을 확인하기 위해 저장된 요청 세트를 유지하세요.
계정에서 현재 키를 얻고 서버 측에 보관하세요. 자격을 갖춘 신규 계정은 7일 동안 $0.50 트라이얼을 요청할 수 있습니다. 인증 및 처리가 필요할 수 있습니다. 테스트하기 전에 사용 가능한 잔액을 확인하세요. 키를 재생성하면 이전 키가 무효화됩니다.
첫 번째 요청
무검열 API를 테스트하기 위해 표준 채팅 완료 요청을 보내세요. 모델 ID는 단순히 uncensored입니다. API는 텍스트 입력을 받고 텍스트 출력을 반환하며, 단순 프롬프트와 구조화된 데이터를 모두 지원합니다.
다음 curl 명령을 사용하여 기본 요청을 보내세요. YOUR_API_KEY을 대시보드에서 받은 실제 키로 바꿉니다.
응답에는 모델의 응답, 토큰 사용량 통계 및 완료 세부 정보가 포함됩니다. 이 엔드포인트는 결합된 프롬프트 및 완료에 최대 100,000개의 토큰을 지원합니다.
제한된 글쓰기 또는 대화 작업에 이 텍스트 엔드포인트를 사용하세요. 소스 자료와 제약 조건을 제공하고, 응답을 애플리케이션의 나머지 부분에 전달하기 전에 검사하세요.
curl https://api.uncensoredaiapis.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."}]
}'
Python SDK 통합
공식 OpenAI Python SDK를 사용하여 무검열 API와 상호 작용하세요. base_url을 우리 엔드포인트로 설정하고 API 키를 제공하세요. 이렇게 하면 전용 모델로 chat.completions.create과 같은 익숙한 메서드를 사용할 수 있습니다.
다음 Python 스니펫은 간단한 텍스트 생성 요청을 보여줍니다. openai 패키지가 설치되어 있는지 확인하세요. 아래 코드는 클라이언트를 무검열 LLM API에 맞게 올바르게 구성하는 방법을 보여줍니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.uncensoredaiapis.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 SDK 통합
OpenAI Node.js 클라이언트에서는 이 서비스의 base URL과 현재 API 키를 설정한 후 chat.completions.create를 호출하세요. 응답된 메시지를 애플리케이션의 다른 부분에 전달하기 전에 읽으세요. 여기서 호환성은 OpenAI가 제공하는 모든 엔드포인트가 아니라 문서화된 Chat Completions 메서드를 의미합니다.
아래 예시는 채팅 완료 요청을 생성하는 방법을 보여줍니다. 응답을 처리하고 어시스턴트의 메시지를 로깅합니다. 이 접근 방식은 서버 측과 엣지 함수 모두에서 작동합니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.uncensoredaiapis.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);
스트리밍 응답
Uncensored AI API는 스트리밍 응답을 위한 서버 전송 이벤트(SSE)를 지원합니다. 이는 채팅 인터페이스나 실시간 애플리케이션 구축에 유용합니다. 요청에서 stream 매개변수를 true로 설정하세요.
스트리밍은 생성되는 대로 텍스트 청크를 반환하여 지각된 지연 시간을 낮출 수 있습니다. 다음 예시는 표준 HTTP 클라이언트나 SDK에서 스트리밍을 처리하는 방법을 보여줍니다.
stream = 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)
제한, 오류 및 컨텍스트
무검열 API의 운영 제한을 이해하세요. API 키당 분당 300개 요청이 허용됩니다. 최대 요청 본문 크기는 8 MB입니다. 이러한 제한은 안정성을 위해 무검열 LLM API에 적용됩니다.
일반적인 오류에는 잘못된 키에 대한 401 Unauthorized, 크레딧이 고갈되었을 때 402 Payment Required, 속도 제한에 대한 429 Too Many Requests이 포함됩니다. 컨텍스트 창은 전체 대화(프롬프트 + 완료)에 대해 100,000개의 토큰입니다.
콘텐츠 제한은 미성년자에 대해 엄격합니다: 미성년자가 관련된 성 콘텐츠는 항상 차단됩니다. 기타 합법적인 성인 콘텐츠는 허용됩니다. 크레딧은 선불 크레딧이며 만료되지 않습니다. 추가 충전은 $20부터 시작하며, 더 많은 금액에 대한 보너스가 제공됩니다.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| Base URL | https://api.uncensoredaiapis.com/v1 |
| 모델 ID | uncensored |
| 인증 | Authorization: Bearer YOUR_KEY |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| JSON 모드 | response_format: {"type": "json_object"} |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 동시 요청 | 키당 동시 8개 |
| 속도 제한 | 키당 분당 300회 |
| 요청 크기 | 최대 8 MB |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| 코드 | 유형 | 의미 |
|---|---|---|
400 | bad_request | 잘못된 JSON, 빈 메시지, 잘못된 파라미터 또는 컨텍스트 초과 |
401 | missing_key · invalid_key · key_revoked | 키 없음·잘못됨·새 키로 교체됨 |
402 | no_credit | 잔액 없음 — 충전하면 즉시 재개 |
403 | content_blocked | 미성년자 관련 성적 콘텐츠 — 거부, 과금 없음 |
404 | not_found | 알 수 없는 엔드포인트 |
413 | request_too_large | 본문 8 MB 초과 |
429 | rate_limited · concurrency | 분당 300회 또는 동시 8개 초과 — 잠시 후 재시도 |
503 | upstream_busy | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
Uncensored AI API는 OpenAI와 동일한가요?
아니요. 당사는 자체 서버에서 자체 전용 오픈 웨이트 무검열 모델을 실행합니다. GPT, Claude 또는 기타 벤더의 모델이 아닙니다. 형식은 OpenAI와 호환되지만 기원은 다릅니다.
속도 제한을 초과하면 어떻게 됩니까?
429 Too Many Requests 오류가 발생합니다. 제한은 API 키당 분당 300개 요청입니다. 필요시 키를 재생성할 수 있지만, 제한은 키 변경이 아닌 시간을 기준으로 초기화됩니다.
체험을 위해 신용카드가 필요합니까?
아니요. 7일 동안 유효한 $0.50 무료 체험 크레딧은 이메일과 비밀번호만 필요합니다. API 키 페이지에서 한 번의 클릭으로 이 크레딧을 청구하세요. 무검열 API 테스트를 시작하려면 카드가 필요하지 않습니다.