설치 및 구성
언어용 공식 SDK를 설치하세요. 클라이언트는 요청을 당사 서버로 라우팅하기 위해 API 키와 올바른 기본 URL만 필요합니다. 이 설정은 모든 표준 OpenAI 호환 클라이언트에서 작동합니다.
환경 변수를 구성하거나 클라이언트 생성자에 직접 전달하세요. 복잡한 라우팅 로직을 관리하거나 여러 모델 간에 전환할 필요가 없습니다. 단일 uncensored 모델이 모든 요청을 처리합니다.
- 패키지 매니저를 통해 패키지를 설치하세요.
- 대시보드에서 API 키를 가져오세요.
- 클라이언트를 API 엔드포인트에 연결하세요.
첫 번째 요청 수행하기
채팅 완료 엔드포인트로 POST 요청을 보내십시오. 모델 ID를 "uncensored"로 설정합니다. 이는 표준 콘텐츠 필터를 우회하여 모델에서 직접 텍스트 응답을 반환합니다. 간단한 프롬프트나 복잡한 시스템 지시문을 보낼 수 있습니다.
API는 temperature와 top_p와 같은 표준 매개변수를 허용합니다. 다음 cURL 명령을 사용하여 연결 및 응답 품질을 즉시 확인할 수 있습니다.
curl https://api.chatbotunrestricted.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "Fetch current temperature in Tokyo."}]
}'이 응답은 모델이 활성 상태이며 프로덕션 트래픽에 준비되었음을 확인합니다.
ストリーミングレスポンスの処理
stream 파라미터를 true로 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트(SSE) 스트림을 반환하여 생성되는 대로 토큰을 전달합니다. 이는 최종 사용자의 지각된 지연 시간을 크게 줄입니다.
SSE 청크를 파싱하여 UI를 실시간으로 업데이트하세요. 최종 청크에는 요청의 총 토큰 사용량이 포함됩니다. 이 방법은 사용자가 즉각적인 피드백을 기대하는 채팅 인터페이스에 필수적입니다.
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)클라이언트가 스트림 종료 이벤트를 올바르게 처리하는지 확인하세요.
도구 및 함수 호출 사용
요청에 도구를 정의하여 모델이 구조화된 함수 호출을 출력하도록 하세요. tools 배열에 도구 정의를 전달하고 자동 선택을 위해 tool_choice를 지정하세요. 모델은 응답 콘텐츠에서 함수 호출을 반환합니다.
함수 인수를 파싱하여 코드에서 실행하세요. 그런 다음 결과를 후속 메시지에서 모델에 전달하세요. 이 사이클은 외부 파싱 로직 없이 복잡한 다단계 워크플로우를 가능하게 합니다.
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.chatbotunrestricted.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);항상 실행 전에 출력 스키마를 검증하세요.
토큰 및 제한 관리
컨텍스트 윈도우는 프롬프트와 완성을 합쳐 100,000개의 토큰을 지원합니다. 각 요청은 최대 16,000개의 토큰을 출력할 수 있으며, max_tokens을 생략한 경우 2,048개입니다. 응답의 토큰 수를 통해 사용량을 모니터링하세요.
속도 제한은 키당 분당 300회 요청과 8개의 동시 요청을 허용합니다. 이러한 제한을 초과하면 429 오류가 발생합니다. 계정당 키를 고유하게 유지하여 제한 공유를 피하세요.
401은 잘못된 키를, 402는 크레딧이 부족함을 나타냅니다. 소규모 콘텐츠 위반으로 인한 거부는 무료이며 토큰을 소모하지 않습니다.
오류 처리 및 문제 해결
애플리케이션 로직에서 HTTP 오류를 적절히 처리하세요. 401 상태 코드는 API 키가 잘못되었거나 만료되었음을 의미합니다. 키가 활성 상태인지 대시보드에서 확인하세요.
402 상태는 사전 결제된 크레딧이 부족함을 나타냅니다. USDT 또는 USDC로 충전하여 서비스를 다시 시작하세요. 429 오류는 속도 제한에 도달했음을 나타냅니다. 대기 후 지수 백오프(exponential backoff)로 다시 시도하세요.
잘못된 요청 본문은 400 오류를 반환합니다. JSON 구조가 API 명세와 일치하는지 확인하세요. 이러한 오류는 무료이며 잔액에서 차감되지 않습니다.
Python
from openai import OpenAI
client = OpenAI(base_url="https://api.chatbotunrestricted.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)