uncensored.com LLM API의 단계별 통합
uncensored LLM을 애플리케이션에 통합하려면 base URL과 인증 헤더를 정밀하게 구성해야 합니다. 이 가이드는 표준 OpenAI 호환 SDK를 사용하여 텍스트 생성, 스트리밍, 도구 사용 기능을 위한 uncensored.com API 설정 방법을 안내합니다.
마지막 업데이트
요약
- API는 모든 요청에 대해 기본 URL HTTPS://api.uncensoredaicom.com/v1과 모델 ID "uncensored"를 사용합니다.
- 인증은 Google 또는 이메일로 가입한 후 얻은 Authorization 헤더의 Bearer 토큰을 통해 처리됩니다.
- stream=true를 설정하여 스트리밍 응답을 활성화하면 Server-Sent Events를 통해 토큰이 제공됩니다.
- 가격은 투명하며 입력 토큰 100만 토큰당 $0.15, 출력 토큰 100만 토큰당 $0.50이며 선불 암호화폐 크레딧은 만료되지 않습니다.
필수 조건: SDK 및 환경 설정
선호하는 언어의 SDK를 설치하여 엔드포인트와 통신하세요. 대부분의 개발자는 Python, Node.js 또는 Go용 공식 OpenAI SDK를 사용합니다. 이는 API가 표준 OpenAI 채팅 완료 스키마를 따르기 때문입니다.
환경에 Python 3.8+ 또는 Node.js 18+가 설치되어 있는지 확인하세요. pip 또는 npm을 통해 패키지를 설치하세요. 대시보드에서 API 키가 필요합니다. 회원가입 시 전화번호는 필요하지 않습니다.
- Python:
pip install openai - Node.js: npm install openai
npm install openai
API 키를 환경 변수에 저장하세요. 이렇게 하면 버전 관리 시스템에 키가 우발적으로 노출되는 것을 방지할 수 있습니다. 이 키는 uncensored 모델에 대한 접근 권한을 부여합니다.
베이스 URL 구성
올바른 기본 URL로 SDK 클라이언트를 설정하세요. 이는 성공적인 통합을 위한 가장 중요한 단계입니다. 기본 OpenAI 기본 URL은 이 서비스에서 작동하지 않습니다.
기본 URL을 HTTPS://api.uncensoredaicom.com/v1로 설정하세요. 이는 요청을 uncensored LLM 인프라로 보냅니다. 전송해야 하는 모델 ID는 "uncensored"입니다. 최소 거부용으로 튜닝된 오픈 웨이트 모델입니다.
models 엔드포인트를 호출하여 연결을 확인하세요. 이는 자격 증명과 기본 URL이 올바른지 확인합니다. 성공적인 응답은 모델 ID와 객체 유형을 반환합니다.
인증 및 헤더 설정
Authorization 헤더에 API 키를 전달하세요. 모든 요청에 Bearer 스키마를 사용하세요. 이 헤더는 선불 크레딧 계정을 인증합니다.
다음과 같이 헤더를 설정하세요: Authorization: Bearer YOUR_API_KEY. SDK는 키를 클라이언트 생성자에 전달하면 이를 자동으로 처리합니다. 불필요한 공백이 포함되지 않도록 주의하세요. 유효하지 않은 키는 401 Unauthorized 오류를 반환합니다.
계정당 활성 키 하나를 제공합니다. 새 키 생성은 이전 키를 무효화합니다. 이는 키 회전 및 보안 관리를 단순화합니다. 키를 배포 환경에 안전하게 보관하세요.
표준 채팅 요청 보내기
/v1/chat/completions으로 POST 요청을 보내세요. role과 content 객체의 배열로 메시지를 보내세요. 시스템은 user, assistant, system 역할을 지원합니다.
구조 예시: {"model": "uncensored", "messages": [{"role": "user", "content": "Hello"}]}. API는 텍스트 완성을 반환합니다. 컨텍스트 윈도우는 총 100,000 토큰입니다. 요청당 최대 출력은 16,000 토큰입니다.
에러 및 거절은 크레딧을 소모하지 않습니다. 이는 선결제 잔액을 보호합니다. 제어를 위해 temperature와 top_p를 설정하십시오. 기본값은 대부분의 사용 사례에 적합합니다.
실시간 출력을 위한 스트리밍 활성화
設定 stream: true 요청 본문에 포함하세요. 이 기능은 서버 전송 이벤트(SSE)를 활성화합니다. 토큰은 전체 완료를 기다리는 대신 점진적으로 도착합니다.
SSE 스트림을 파싱하여 텍스트를 실시간으로 표시하세요. 마지막 청크에는 토큰 사용량 통계가 포함됩니다. 이를 통해 정확한 청구 내역을 추적할 수 있습니다. 스트리밍은 최종 사용자의 지각된 지연 시간을 줄여줍니다.
네트워크 중단 사항을 우아하게 처리하세요. 스트림이 끊기면 다시 연결하세요. uncensored API는 안정적인 스트리밍을 지원합니다. 연결 상태를 모니터링하세요. 채팅 인터페이스나 장문 생성에 사용하세요.
도구 및 함수 호출 사용 중
요청 본문에 도구를 정의하세요. 함수 스키마 목록을 전달하세요. 모델은 사용자 의도에 따라 이러한 함수를 호출할 수 있습니다. 이를 통해 에이전트와 유사한 동작이 가능해집니다.
Specify tool_choice 함수 선택을 제어합니다. 사용 auto 자동 감지에 대해. API는 표준 도구 정의를 지원합니다. 응답에서 함수 호출 인수를 구문 분석하세요.
코드에서 함수 실행을 구현하세요. 결과를 메시지로 전송하세요. 모델은 대화를 계속합니다. 이를 통해 복잡한 워크플로우를 구현할 수 있습니다. 테스트를 통해 인자 파싱의 정확성을 확인하세요.
JSON 모드 응답 처리
設定 response_format: {"type": "json_object"}. 이는 모델이 유효한 JSON을 출력하도록 강제합니다. 구조화된 데이터 추출에 사용하세요. 잘못된 응답 오류를 방지합니다.
코드에서 JSON 문자열을 파싱하세요. 잠재적 파싱 오류를 처리하세요. JSON 모드는 API 통합의 신뢰성을 높입니다. 데이터 처리 파이프라인에 이상적입니다.
JSON 모드와 시스템 프롬프트를 결합하세요. 모델이 특정 스키마로 출력하도록 유도하세요. 이는 일관된 형식을 보장합니다. 사용하기 전에 출력을 검증하세요. 이는 하류 오류를 줄여줍니다.
모니터링 제한 및 오류
속도 제한을 준수하세요. 키당 분당 300회 요청이 허용됩니다. 최대 8개의 동시 요청이 가능합니다. 요청 본문 크기는 8 MB로 제한됩니다.
HTTP 상태 코드를 모니터링합니다. 429는 속도 제한 초과를 나타냅니다. 400은 잘못된 요청을 나타냅니다. 500은 서버 오류를 나타냅니다. 재시도를 위해 지수 백오프를 구현합니다. 이는 API에 과부하를 방지합니다.
스트리밍의 마지막 청크에서 토큰 사용량을 추적하세요. 이는 선불 크레딧을 관리하는 데 도움이 됩니다. 오류는 토큰을 소모하지 않으므로 잔액이 보호됩니다. 정기적인 모니터링은 원활한 운영을 보장합니다.
비용 및 토큰 사용량 계산
가격은 투명하며 선불제입니다. 입력 토큰은 100만 개당 $0.15, 출력 토큰은 100만 개당 $0.50입니다. 크레딧은 만료되지 않습니다. 월 구독료가 없습니다.
암호화폐만 충전하세요. USDT(TRC20) 또는 USDC(Base). 금액은 $20에서 $500 사이입니다. 더 큰 충전 시 보너스 크레딧이 적용됩니다. $50부터 +5%, $100부터 +10%, $200부터 +15%.
사용량이 많기 전에 비용을 계산합니다. 프롬프트에 대한 토큰 수를 추정합니다. 이는 효과적인 예산 편성에 도움이 됩니다. 오류는 무료이며 환불은 제공되지 않지만 실수는 수정됩니다. 지출 추적을 위해 대시보드를 사용하세요.
자주 묻는 질문
무검열ai.com은 OpenAI SDK와 호환되나요?
네, 이 API는 OpenAI와 완전히 호환됩니다. Python, Node.js 및 기타 언어용 표준 OpenAI SDK를 사용할 수 있습니다. 기본 URL을 HTTPS://api.uncensoredaicom.com/v1로 변경하고 API 키를 전달하면 됩니다. 모델 ID는 "uncensored"입니다. 동일한 요청 및 응답 구조를 따릅니다.
허용되는 암호화폐 결제는 무엇인가요?
TRC20 네트워크의 USDT와 Base 네트워크의 USDC를 지원합니다. $20부터 $500까지 정수 금액으로 충전할 수 있습니다. 보너스 크레딧이 자동으로 추가됩니다: $50부터 +5%, $100부터 +10%, $200부터 +15%.
선불 크레딧은 만료되나요?
아니요, 선불 크레딧은 만료되지 않습니다. 월별 구독 요금이나 사용 기한이 없습니다. 사용한 만큼만 지불하며, 오류로 인해 크레딧이 소모되지 않습니다. 이 모델은 실제 가치에 대해서만 지불함을 보장합니다.
이 API를 NSFW 콘텐츠에 사용할 수 있나요?
네, 해당 모델은 검열 없이 설계되었으며 합법적인 성인, 허구적 또는 논란이 되는 주제도 거부하지 않습니다. 제한 없는 텍스트 생성을 위해 설계되었습니다. 유일한 제한 사항은 미성년자를 대상으로 한 콘텐츠로, 이는 항상 거부됩니다. NSFW 챗봇 및 창의적인 글쓰기에 이상적입니다.
API 키 생성
등록하고, 키를 검색한 후 엔드포인트를 업데이트하세요. 최소한의 설정이 필요합니다.
