Uncensored API 문서

빠른 시작: 첫 번째 요청 보내기

The Unzensierte API는 OpenAI 호환 서비스입니다. API 키를 사용하여 텍스트 생성을 위해 토큰당 요금을 지불합니다. API 키를 포함하여 chat completions 엔드포인트로 POST 요청을 보내십시오. 모델은 프롬프트를 처리하고 텍스트 출력을 직접 반환합니다.

키로 인증한 후 모델 ID를 "uncensored"로 정의하세요. 역할과 내용을 가진 메시지 배열을 지정하세요. 서버는 생성된 텍스트로 응답합니다. 이는 표준 HTTP 클라이언트 또는 SDK와 함께 작동합니다. 원본 텍스트가 제공되며 추가 형식 오버헤드가 없습니다. 오류는 오류 코드가 포함된 JSON을 반환합니다. 복잡한 애플리케이션을 빌드하기 전에 설정을 확인하기 위한 빠른 경로를 사용하세요.

인증 및 Base URL

인증은 단일 API 키를 헤더에 전달하여 수행합니다. 기본 URL은 HTTPS://api.unzensierte.cc/v1입니다. 이 URL은 base_url 매개변수를 설정하여 공식 OpenAI SDK와 함께 작동합니다. 키는 계정을 식별하고 토큰 사용량을 추적합니다. API 키 페이지에서 키를 생성하세요. Google 또는 이메일로 가입한 직후 키가 즉시 표시됩니다. 모든 요청에 이 키를 사용하세요. 유효하지 않은 키는 401 오류를 반환합니다. 키가 만료되었거나 크레딧이 부족하면 402 오류가 발생합니다.

키를 안전하게 보관하세요. 계정당 하나의 활성 키만 허용됩니다. 새 키는 이전 키를 대체합니다. 가입 시 전화번호가 필요하지 않습니다. API 키만 접근을 위한 자격 증명으로 필요합니다.

채팅 완료 엔드포인트

핵심 엔드포인트는 POST /v1/chat/completions입니다. 모델, 메시지 및 매개변수가 포함된 JSON 페이로드를 받습니다. 모델 ID는 "uncensored"입니다. 메시지는 역할과 콘텐츠 문자열이 필요합니다. 시스템은 choices 배열에서 생성된 텍스트로 응답합니다. temperature, top_p 및 stop 시퀀스를 설정할 수 있습니다. 이러한 매개변수는 창의성과 출력 길이를 제어합니다. API는 응답에서 토큰 사용량을 반환합니다. 오류에는 메시지 및 유형이 포함됩니다. 모든 텍스트 생성 작업에 이 엔드포인트를 사용하십시오. 사용 가능한 유일한 텍스트 엔드포인트입니다. 임베딩이나 이미지 생성은 여기서는 제공되지 않습니다.

스트리밍 응답 및 사용량

stream을 true로 설정하여 스트리밍을 활성화합니다. API는 서버 전송 이벤트(SSE)를 전송합니다. 각 청크에는 부분 텍스트가 포함됩니다. 마지막 청크에는 토큰 사용량 데이터가 포함됩니다. 이를 통해 생성된 텍스트를 실시간으로 표시할 수 있습니다. 애플리케이션에서 청크를 버퍼링합니다. 결합하여 전체 응답을 구성합니다. 스트리밍은 긴 출력의 지각된 지연 시간을 줄입니다. 채팅 인터페이스나 실시간 데이터 처리에 사용합니다. usage 객체는 마지막 청크에만 나타납니다. 청구를 위해 입력 및 출력 토큰을 추적합니다. 스트리밍 중 오류가 발생해도 청크에 오류 객체가 반환됩니다.

함수 호출 및 JSON 모드

외부 도구를 통합하기 위해 함수 호출을 사용하세요. 요청 본문에 도구를 정의하세요. 모델은 인수를 포함하는 도구 호출을 반환합니다. 이러한 인수를 구문 분석하여 함수를 실행하세요. tool_choice를 auto 또는 특정 함수 이름으로 설정하세요. JSON 모드는 출력을 유효한 JSON으로 강제합니다. response_format을 json_object로 설정하세요. 이는 구문 분석을 위한 구조화된 데이터를 보장합니다. 자동화 워크플로우에 이러한 기능을 사용하세요. 복잡한 에이전트 동작을 위해 결합하세요. 모델은 표준 OpenAI 도구 형식을 지원합니다. 도구 정의가 예상 스키마와 일치하는지 확인하세요.

제한 사항 및 오류 처리

속도 제한은 키당 분당 300개의 요청입니다. 동시성은 동시에 8개의 요청으로 제한됩니다. 요청 본문은 8MB 미만이어야 합니다. 오류에는 키가 유효하지 않음을 나타내는 401과 같은 특정 코드가 포함됩니다. 402는 선불 크레딧 부족을 나타냅니다. 429는 속도 제한 초과를 신호합니다. 컨텍스트 윈도우는 총 100,000개의 토큰입니다. 최대 출력은 요청당 16,000개의 토큰입니다. 오류는 오류 세부 정보가 포함된 JSON을 반환합니다. 429 오류에 대한 재시도를 처리하십시오. 많은 사용 전에 크레따 잔액을 확인하십시오. 소비된 크레딧에 대한 환불은 제공되지 않습니다.

cURL

Copycurl https://api.unzensierte.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List 5 common Linux commands for file management"}]
  }'

Python

Copyfrom openai import OpenAI

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