Unfiltered AI API 빠른 시작 가이드
Chat Completions 요청의 인증 방법을 확인하고 응답 및 사용량 필드를 검사하며, 스트리밍과 오류 처리 방법을 알아보세요. 응답 검증 및 대화 저장 로직은 애플리케이션에서 관리하세요.
- $0.15입력 토큰 1M당
- $0.50출력 토큰 / 1M
- 100,000토큰 컨텍스트
- $0.50체험 크레딧
- 300분당 요청
Base URL 및 인증
무검열 AI API를 사용하려면 요청을 전용 Base URL로 보내야 합니다: https://api.unfilteredaiapi.com/v1. 이 엔드포인트는 표준 OpenAI SDK 및 클라이언트와 호환됩니다. 인증하려면 API 키가 필요합니다. API 키 페이지에서 이메일과 비밀번호로 가입하여 키를 즉시 받으세요. 키는 하나의 계정에 연결되지만 언제든지 재생성할 수 있으며, 이전 키는 무효화됩니다.
Authorization 헤더에 Bearer 토큰 형태로 키를 전달하세요. 전송해야 하는 모델 식별자는 uncensored이며, 이는 자체 GPU 서버에서 실행되는 오픈 웨이트 모델입니다. 이 모델은 GPT, Claude 또는 기타 벤더의 모델이 아닙니다.
첫 번째 요청
인증과 응답 형식을 확인하기 위해 작은 Chat Completions 요청을 보내세요. 메시지 및 토큰 사용량을 확인하고, 클라이언트에서 오류 또는 거부된 출력을 처리하세요.
curl https://api.unfilteredaiapi.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."}]
}'choices 배열이 있는 JSON 응답을 받으면 구성이 올바릅니다. API는 텍스트 입력 및 출력만 지원하며, 임베딩, 이미지 또는 오디오 엔드포인트는 없습니다.
Python SDK 연동
무검열 API와 상호 작용하려면 공식 OpenAI Python 라이브러리를 사용하세요. 클라이언트 초기화 시 base_url 및 api_key을 구성하세요. 이렇게 하면 기존 코드 구조를 유지하면서 기본 모델 동작을 전환할 수 있습니다.
from openai import OpenAI
client = OpenAI(base_url="https://api.unfilteredaiapi.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)이 접근 방식은 모든 OpenAI 호환 클라이언트에 적용됩니다. 요청에서 모델을 uncensored로 지정하세요. API는 OpenAI 스키마에 따라 토큰화 및 응답 형식을 처리합니다.
Node SDK 연동
이 API의 베이스 URL, 현재 키 및 uncensored 모델을 사용하여 Node.js Chat Completions 클라이언트를 구성하세요. 채팅 애플리케이션에 사용하기 전에 응답 형식, 스트리밍 동작 및 오류 처리 경로를 확인하세요.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.unfilteredaiapi.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);baseURL을 https://api.unfilteredaiapi.com/v1로 설정하고 API 키를 제공하세요. model 매개변수는 uncensored로 설정해야 합니다. 이 설정은 후속 섹션에서 설명하는 스트리밍 및 함수 호출을 지원합니다.
스트리밍 응답 (SSE)
API는 실시간 토큰 생성을 위해 서버 전송 이벤트(SSE)를 지원합니다. 요청에서 stream 매개변수를 true로 설정하세요. 응답은 단일 JSON 객체가 아닌 청크 시리즈가 됩니다.
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)스트림 이벤트를 처리하여 생성되는 텍스트를 표시하세요. 이는 지연 시간이 중요한 채팅 인터페이스에 유용합니다. 각 청크에는 UI 버퍼에 추가할 수 있는 부분 콘텐츠가 포함되어 있습니다.
제한, 오류 및 컨텍스트
귀하의 요청은 키당 분당 300회 요청의 제한을 받습니다. 요청 본문은 8 MB를 초과할 수 없습니다. 인증에 실패하면 401 오류가 발생합니다. 선불 크레딧이 고갈되면 API는 402 오류를 반환합니다. 속도 제한을 초과하면 429 오류가 발생합니다.
프롬프트와 완료를 합한 컨텍스트 창은 100,000 토큰입니다. 잘림을 피하려면 입력이 이 제한 내에 들어오는지 확인하세요. 필요시 접근 권한을 무효화하기 위해 무검열 API 키를 재생성할 수 있습니다.
기술 사양
크레딧을 구매하기 전에 확인할 수 있도록 API의 실제 한도와 기능을 한곳에 정리했습니다.
| 항목 | 내용 |
|---|---|
| 형식 | OpenAI 호환: 어떤 OpenAI SDK든 base URL과 키만 바꾸면 동작 |
| 모델 ID | uncensored |
| Base URL | https://api.unfilteredaiapi.com/v1 |
| 엔드포인트 | POST /v1/chat/completions · GET /v1/models |
| 인증 | Authorization: Bearer YOUR_KEY |
| 스트리밍 | 지원 — SSE, 마지막 청크에 토큰 사용량 포함 |
| 함수 호출 | 지원 — tools, tool_choice; 응답에 tool_calls (스트리밍 포함), 결과는 role: tool로 전송 |
| JSON 모드 | response_format: {"type": "json_object"} |
| 컨텍스트 창 | 100,000 토큰 (입력 + 출력) |
| 최대 출력 | 100,000 토큰 윈도우의 남은 만큼; max_tokens는 선택 사항(별도 상한 없음) |
| 파라미터 | temperature, top_p, stop, seed, presence_penalty, frequency_penalty |
| 동시 요청 | 키당 동시 8개 |
| 응답 헤더 | X-Request-Id, X-Balance-USD, X-RateLimit-Limit-Requests, X-RateLimit-Limit-Concurrency |
| 속도 제한 | 키당 분당 300회 |
| 요청 크기 | 최대 8 MB |
| 보너스 | $50 이상 +5%, $100 이상 +10%, $200 이상 +15% |
| 무료 체험 | $0.50, 7일, 카드 불필요 · 체험 키: 동시 요청 2건, 분당 60건. 첫 충전 후 전체 한도(8건, 300건) 적용 |
| 유효기간 | 유료 크레딧은 만료되지 않으며 구독 없음 |
| 가격 | 입력 100만 토큰당 $0.15 · 출력 100만 토큰당 $0.50 |
| 충전 | USDT (TRC20) 또는 USDC (Base), $20~$500 사이 원하는 정수 금액 |
| 과금 | 선불 크레딧에서 실제 사용량만큼 차감, 오류·거부는 무료 |
| 콘텐츠 | 성인 콘텐츠 허용, 미성년자가 관련된 성적 콘텐츠는 거부 |
| 로그인 | Google 또는 이메일과 비밀번호 |
| 키 | 계정당 활성 키 1개, 새 키를 만들면 이전 키는 무효 |
오류 코드
오류는 고정된 type을 가진 JSON으로 반환되며, 실패하거나 거부된 요청은 과금되지 않습니다.
| HTTP | 유형 | 의미 |
|---|---|---|
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 | 모델 혼잡 — 몇 초 후 재시도 |
질문과 답변
컨텍스트 창 크기는 얼마인가요?
컨텍스트 창은 100,000 토큰이며, 프롬프트와 완료를 모두 포함합니다. 총 토큰 수가 이 제한 내에 있는지 확인하세요.
속도 제한은 어떻게 처리하나요?
키당 분당 300개 요청으로 제한됩니다. 이를 초과하면 429 오류가 발생합니다. 클라이언트에서 지수 백오프를 구현하는 것을 고려하세요.
모델이 GPT-4인가요?
아니요. 모델 ID는 'uncensored'입니다. 이 모델은 GPT, Claude 또는 기타 벤더의 모델이 아닌, 전용 GPU 서버에서 실행되는 오픈 웨이트 모델입니다.