API 문서 & 시작하기

Base URL 및 인증

베이스 URL을 HTTPS://api.uncensoredal.com/v1로 설정하고 Authorization 헤더에 API 키를 전달하세요. 계정당 활성 키 하나를 받으며, 새 키를 생성하면 이전 키가 즉시 무효화됩니다. 이 간단한 설정은 복잡한 라우팅 로직 없이 모든 표준 OpenAI 호환 클라이언트와 함께 작동합니다.

Copycurl https://api.uncensoredal.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Generate the next 50 lines of a python script"}]
  }'

엔드포인트는 채팅 완료 전용이므로 모델 라우팅을 관리할 필요가 없습니다. 모든 요청에는 올바른 추론 서버에 접근하기 위해 모델 식별자 "uncensored"가 포함되어야 합니다. 인증 실패 시 키가 없거나 유효하지 않으면 401 상태 코드가 반환됩니다.

채팅 완료 엔드포인트

messages 배열에 메시지 기록을 사용하여 /v1/chat/completions으로 POST 요청을 보내세요. 시스템은 텍스트 입력을 처리하고 합법적인 성인 사용에 대한 콘텐츠 거부 없이 생성된 텍스트를 반환합니다. 호환성을 보장하기 위해 페이로드에서 모델을 "uncensored"로 지정해야 합니다.

Copyfrom openai import OpenAI

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

요청은 실제 토큰 사용에 따라 과금되며, 오류와 거부는 무료입니다. 이 선불 모델은 소비한 만큼만 지불함을 의미합니다. 엔드포인트는 출력 무작위성을 제어하기 위해 temperature와 top_p과 같은 표준 매개변수를 지원합니다.

SSE를 사용한 스트리밍 응답

요청 본문에서 stream을 true로 설정하여 스트리밍을 활성화하고 서버 전송 이벤트를 통해 토큰을 받으세요. 각 청크에는 최종 청크에 토큰 사용 통계가 포함되어 있어 실시간으로 비용을 추적할 수 있습니다. 이 접근 방식은 긴 생성의 지각된 지연 시간을 줄입니다.

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)

텍스트가 생성되는 대로 표시해야 하는 채팅 인터페이스를 구축할 때 스트리밍을 사용하세요. API는 표준 OpenAI 호환 스트림 이벤트를 반환하므로 기존 UI 라이브러리와 쉽게 통합할 수 있습니다. 사용자가 입력을 변경하면 스트림을 조기에 중단할 수 있습니다.

함수 호출 및 JSON 모드

함수 호출을 활성화하거나 response_format을 사용하여 JSON 출력을 강제하기 위해 요청에 도구를 정의하세요. API는 모델이 함수를 호출해야 할 시점에 대한 정밀한 제어를 위해 tool_choice를 지원합니다. 이 기능은 표준 OpenAI 스키마와 함께 작동하므로 기존 도구 정의를 재사용할 수 있습니다.

Copyimport OpenAI from "openai";

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

JSON 모드는 출력이 유효한 JSON이 되도록 보장하며, 이는 프로그래밍적으로 구조화된 데이터를 파싱하는 데 유용합니다. 창의성과 구조적 신뢰성 사이의 균형을 맞추기 위해 temperature 설정과 결합할 수 있습니다. API는 함수 호출 세부 정보를 반환하여 코드가 처리할 수 있도록 도구 실행 로직을 처리합니다.

모델 매개변수 구성

생성 동작을 제어하기 위해 temperature, top_p, stop 시퀀스 및 seed와 같은 매개변수를 구성하세요. 컨텍스트 창은 프롬프트와 완료를 합쳐 100,000 토큰까지 지원합니다. 최대 출력은 요청당 16,000 토큰으로 제한되며, max_tokens을 지정하지 않을 경우 2,048 토큰으로 제한됩니다.

긴 텍스트에서 반복을 줄이기 위해 presence_penalty와 frequency_penalty를 사용할 수 있습니다. 이러한 매개변수는 기본 가중치를 변경하지 않고 모델의 스타일을 미세 조정할 수 있게 합니다. 특정 사용 사례에 맞는 적절한 균형을 찾기 위해 점진적으로 조정하세요.

제한 사항, 오류 및 컨텍스트

초당 요청 제한은 분당 300회, 키당 동시 요청 8개로 설정됩니다. 요청 본문은 8MB로 제한되므로 큰 컨텍스트 윈도우는 신중하게 관리해야 합니다. 오류에는 유효하지 않은 키에 대한 401, 잔액 부족에 대한 402, 속도 제한에 대한 429가 포함됩니다.

크레딧은 만료되지 않으므로 버스트 간 사용 중단을 해도 자금을 잃지 않습니다. 동시 제한에 도달하면 지수 백오프로 재시도하세요. 100,000 토큰의 컨텍스트 윈도우는 광범위한 히스토리를 허용하지만, 잘림을 피하기 위해 출력 제한에 주의하세요.