API 문서

인증 및 Base URL

API는 인증을 위해 단일 API 키가 필요합니다. Google 또는 이메일 주소로 가입하면 즉시 이 키를 받습니다. 다음에 전달하세요 Authorization Bearer 토큰으로 헤더를 사용합니다. 베이스 URL은 https://api.topuncensored.com/v1이 URL은 모든 OpenAI 호환 SDK 또는 클라이언트 라이브러리와 함께 작동합니다.

• 헤더를 사용하세요: Authorization: Bearer YOUR_API_KEY
• 클라이언트의 기본 URL을 제공된 엔드포인트로 설정하세요.

이러한 구성은 핵심 로직을 변경하지 않고도 라이브러리를 교체할 수 있도록 보장합니다.

Copycurl https://api.topuncensored.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate a list of ten distinct UI layout patterns."}]
  }'

채팅 완료 엔드포인트

에 텍스트 프롬프트를 보내세요 /v1/chat/completions 엔드포인트입니다. 모델 ID는 uncensored. 이 엔드포인트는 메시지가 있는 표준 채팅 형식을 처리합니다. 텍스트 응답을 직접 반환합니다. 추가 레이어나 래퍼가 없습니다. 100,000 토큰의 컨텍스트 윈도우를 제어합니다. 8 MB 미만의 요청은 안정적으로 작동합니다. 직접 텍스트 생성에 사용하십시오.

system 프롬프트와 user 메시지로 요청을 구조화합니다. 모델은 합법적인 성인 콘텐츠를 필터링하지 않고 응답합니다. 누락된 키와 같은 오류는 401을 반환합니다. 크레딧이 부족하면 402 오류가 발생합니다. 이러한 것은 명확한 신호입니다.

스트리밍 응답

stream을 true로 설정하여 스트리밍 활성화 stream: true생성되는 대로 텍스트 청크를 받게 됩니다. 이는 긴 출력의 지각된 지연 시간을 줄입니다. 마지막 청크에는 토큰 사용 데이터가 포함됩니다. 실시간 표시 또는 점진적 렌더링에 사용하세요. 이는 대용량 애플리케이션에 효율적입니다.

각 청크를 파싱하여 최종 응답을 구성하세요. 이 방법은 큰 출력을 우아하게 처리합니다. API는 표준 서버 전송 이벤트(Server-Sent Events)를 지원합니다. 이는 대화형 앱에 권장되는 접근 방식입니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.topuncensored.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)

Tool Calling and JSON Mode

구조화된 상호작용을 위해 함수 호출을 사용하세요. 요청에 도구를 정의하세요. 모델은 구조화된 인수를 반환합니다. 설정 response_format 수신하여 {"type": "json_object"} 엄격한 JSON 출력을 위해 이는 예측 가능한 데이터 형식을 보장합니다. 이러한 기능을 결합하여 견고한 통합을 구현하세요. 출력 구조에 대한 정밀한 제어를 얻을 수 있습니다.

도구 호출은 표준 OpenAI 스키마와 함께 작동합니다. JSON 모드는 유효한 JSON을 강제합니다. API 통합 또는 데이터 추출에 이를 사용하세요. 이 유연성은 복잡한 워크플로우를 지원합니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.topuncensored.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);

매개변수 및 한도

조정 temperature, top_p, 그리고 stop 시퀀스. 설정 max_tokens to 16,000. 생략된 경우 기본값은 2,048입니다. 반복을 제어하려면 presence_penalty 및 frequency_penalty다음 사용 seed 결정론적 출력. 이러한 매개변수는 생성 품질을 미세 조정합니다. 출력 스타일에 대해 완전한 제어를 가집니다.

속도 제한은 분당 300회입니다. 동시 요청 수는 최대 8개입니다. 이 제한은 안정적인 성능을 보장합니다. 대시보드를 통해 사용량을 모니터링하세요. 특정 사용 사례에 맞게 매개변수를 조정하여 최적화하세요.

오류 및 컨텍스트 윈도우

오류를 우아하게 처리하세요. 401은 유효하지 않은 키를 의미합니다. 402는 크레딧 부족을 나타냅니다. 429는 속도 제한을 신호합니다. 컨텍스트 윈도우는 총 100,000 토큰입니다. 출력은 최대 16,000 토큰입니다. 토큰을 신중하게 관리하세요. 오류는 크레딧을 소모하지 않습니다. 이는 디버깅 중 비용을 절약합니다. 사용량 통계를 위해 마지막 청크를 사용하세요.

토큰 사용량을 추적하세요. 속도 제한에 도달하지 마세요. 지수 백오프로 재시도하세요. 이는 신뢰할 수 있는 작동을 보장합니다. API는 견고하도록 설계되었습니다. 오류를 정상적인 흐름의 일부로 처리하세요.

Copystream = 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)