API 문서

인증 및 Base URL

API는 모든 요청에 베어러 토큰이 필요합니다. Google 또는 이메일 비밀번호로 로그인하여 'API 키 받기' 페이지에서 키를 생성하세요. 키는 전화 인증 없이 즉시 표시됩니다. 기본 URL은 https://api.uncensoredaigithub.com/v1 공식 OpenAI SDK를 사용하여 base_url 및 api_key 값들입니다. 이 설정은 모든 OpenAI 호환 클라이언트와 함께 작동합니다.

엔드포인트: https://api.uncensoredaigithub.com/v1

Auth Header: Authorization: Bearer YOUR_API_KEY

각 계정은 하나의 활성 키를 지원합니다. 새 키를 발급하면 이전 키가 자동으로 무효화됩니다. 이는 다양한 환경 간에 자격 증명을 교체할 때 토큰 드리프트를 방지합니다.

채팅 완료 엔드포인트

에 텍스트 요청을 보내세요 /v1/chat/completions 모델 ID를 사용하는 엔드포인트입니다 uncensoredAPI는 표준 채팅 메시지를 받아들이고 합법적인 성인 사용에 대한 콘텐츠 필터 없이 텍스트 응답을 반환합니다. 다음과 같은 매개변수를 구성할 수 있습니다. temperature, top_p, 그리고 stop 창의성과 출력 길이를 제어합니다.

컨텍스트 윈도우는 프롬프트와 completion을 합쳐 최대 100,000개의 토큰을 허용합니다. max_tokens을 설정하여 max_tokens 출력을 제어하며, 생략 시 기본값은 2,048 토큰입니다. 오류 및 거절 시 크레딧이 소모되지 않으므로 안전하게 테스트할 수 있습니다.

스트리밍 응답 및 사용량

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. API는 부분 텍스트 청크를 포함하는 서버 전송 이벤트(SSE)를 반환합니다. 토큰 사용량 데이터는 스트림의 마지막 청크에만 나타납니다. 이를 통해 응답을 실시간으로 렌더링하면서도 소비량을 정확하게 추적할 수 있습니다.

스트리밍은 역할극 애플리케이션이나 장문 콘텐츠 생성에 이상적입니다. SSE 스트림을 파싱하여 UI를 점진적으로 업데이트할 수 있습니다. API는 연결이 조기에 끊겨도 사용량 메트릭이 정확하도록 보장합니다.

함수 호출 및 도구들

제공하여 함수 호출을 지원합니다. tools 요청 내의 배열입니다. 모델은 인수가 있는 구조화된 도구 호출을 반환할 수 있습니다. 사용 tool_choice 자동 함수 실행과 같은 특정 동작을 강제합니다. 이 기능은 외부 서비스나 사용자 정의 로직과의 통합을 가능하게 합니다.

이름, 설명, 매개변수 스키마가 있는 함수를 정의하세요. API는 응답에서 함수 이름과 인수를 반환합니다. 이러한 인수를 구문 분석하여 사용자 정의 코드를 실행하세요. 이 기능은 uncensored LLM API를 복잡한 에이전트 워크플로우에 적합하게 만듭니다.

JSON 모드 및 매개변수

설정하여 구조화된 출력 강제 response_format 수신하여 {"type": "json_object"}. 모델은 일반 텍스트 대신 유효한 JSON을 반환합니다. 이는 데이터 추출이나 구성 생성에 유용합니다. 견고한 API 통합을 위해 함수 호출과 결합하세요.

다른 지원 매개변수에는 seed 결정론적 출력, presence_penalty, 그리고 frequency_penalty다음 사용 seed 디버깅을 위해 특정 응답을 재현합니다. 반복을 줄이거나 다양한 어휘를 유도하기 위해 페널티를 조정합니다.

오류 처리 및 제한

API는 분당 300회, 키당 동시 8회의 요청에 대한 속도 제한을 적용합니다. 요청 본문 크기는 8 MB를 초과할 수 없습니다. 이 한도를 초과하면 429 상태 코드가 반환됩니다. 인증 실패 시 401 오류가 발생하며, 잔액 부족 시 402 오류가 발생합니다.

크레딧은 실제 토큰 사용량을 기준으로 과금됩니다. 선불 크레딧은 만료되지 않으므로 월 갱신을 걱정할 필요가 없습니다. 중복 청구와 같은 문제는 지원 페이지를 통해 해결할 수 있습니다.

cURL

Copycurl https://api.uncensoredaigithub.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Run the unit tests for the new auth module."}]
  }'

Python

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

스트리밍

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)