Uncensored API로 시작하세요

Base URL 및 인증 설정

SDK를 우리 엔드포인트로 설정하고 인증 헤더에 키를 전달하세요. 우리는 모든 표준 OpenAI 호환 클라이언트와 호환되는 단일 호스팅 기본 URL을 제공합니다. 계정당 활성 키가 하나 제공되며, 전화번호 없이 Google이나 이메일로 몇 초 만에 가입할 수 있습니다. 키는 생성 즉시 제한 없는 모델에 대한 접근 권한을 부여합니다.

인증은 표준 Bearer 토큰에 기반합니다. 유효하지 않은 키를 보내면 API가 401 오류를 반환합니다. 언제든지 새 키를 생성할 수 있으며, 이전 키는 즉시 작동하지 않게 됩니다. 이 디자인은 사용량을 비공개로 유지하고 접근을 단순하게 유지합니다.

여러 모델 버전을 관리하거나 불투명한 라우팅을 걱정할 필요가 없습니다. 엔드포인트는 성인 콘텐츠와 거부 없음에 맞춰 조정된 특정 대형 언어 모델을 제공합니다. 선불 크레딧에 접근하는 유일한 방법이므로 키를 안전하게 보관하세요.

채팅 완료 엔드포인트 (POST /v1/chat_completions)

텍스트 응답을 받기 위해 프롬프트를 chat completions 엔드포인트로 전송하세요. 이것이 우리 API의 핵심 상호작용 방법입니다. 동작을 설정하기 위한 시스템 메시지와 실제 쿼리를 위한 사용자 메시지로 요청을 구조화합니다. 모델은 입력을 처리하여 텍스트 응답을 반환합니다.

당사의 API는 수행하는 작업에 대해 엄격합니다. 임베딩, 이미지 생성 또는 오디오 처리를 지원하지 않습니다. 텍스트를 입력하고 텍스트를 출력합니다. 컨텍스트 창은 프롬프트와 완성을 합쳐 100,000 토큰을 지원합니다. 이는 긴 대화나 대규모 문서 처리를 가능하게 합니다.

요청을 깔끔하고 구조화되게 유지하세요. 엔드포인트는 특정 JSON 형식을 기대합니다. 잘못된 데이터 유형을 보내면 오류가 발생합니다. 추론의 무거운 작업은 자체 서버에서 처리합니다.

Python SDK 통합 예제

공식 Python SDK를 사용하여 우리 API와 쉽게 상호 작용하세요. 아래 코드는 클라이언트를 우리 base URL과 키로 초기화하는 방법을 보여줍니다. 그런 다음 메시지를 사용하여 채팅 완료 함수를 호출할 수 있습니다.

이러한 구성은 당사 API가 완전히 OpenAI 호환이기 때문에 작동합니다. 커스텀 클라이언트 라이브러리가 필요하지 않습니다. base URL과 API 키만 업데이트하면 됩니다. SDK의 나머지 기능은 동일하게 유지됩니다. 이는 나중에 다른 제공업체로 전환할 때 이주가 원활하도록 합니다.

최상의 경험을 위해 최신 버전의 SDK를 사용하는 것을 추천합니다. 라이브러리가 리트라이와 JSON 파싱을 처리합니다. 프롬프트 로직과 모델 매개변수에 집중하기만 하면 됩니다.

Node SDK 통합 예제

표준 npm 패키지를 사용하여 Node.js에 통합하세요. 구조는 Python 예시를 반영합니다. 베이스 URL을 우리 엔드포인트로 설정하고 API 키를 제공합니다. 이는 기존 Node.js 애플리케이션과의 호환성을 보장합니다.

Node SDK는 HTTP 요청을 자동으로 처리합니다. 메시지 배열을 전달하고 응답 객체를 받습니다. 여기에는 생성된 텍스트의 내용이 포함됩니다. 그런 다음 이 텍스트를 애플리케이션 로직에서 처리할 수 있습니다.

텍스트 완료만 지원한다는 점을 기억하세요. 응답에 이미지나 오디오 데이터가 포함되지 않을 것입니다. SDK는 JSON 응답을 파싱하여 텍스트에 접근할 수 있게 합니다. 이는 언어 간 일관성을 개발 프로세스를 단순화합니다.

스트리밍 응답 및 토큰 사용량

토큰 단위로 응답을 받도록 스트리밍을 활성화하세요. 이는 사용자에게 더 빠른 인지된 지연 시간을 제공합니다. 전체 응답을 기다리는 대신 생성되는 대로 텍스트를 표시할 수 있습니다. 이는 채팅 인터페이스에 중요합니다.

스트림의 마지막 청깅에는 토큰 사용량 통계가 포함되어 있습니다. 이 데이터를 사용하여 비용을 추적하고 계정 잔액을 모니터링할 수 있습니다. 스트리밍은 가격 모델을 변경하지 않습니다. 여전히 사용된 토큰당 요금을 지불합니다.

API는 스트리밍을 위한 서버 전송 이벤트를 지원합니다. SDK가 이벤트 구문을 처리합니다. stream 매개변수를 true로 설정하기만 하면 됩니다. 이는 Python 및 Node 클라이언트 모두에서 작동합니다. 대화형 애플리케이션을 구축하는 데 권장되는 방법입니다.

제한 사항, 오류 및 모델 세부 정보

견고한 애플리케이션을 구축하기 위해 속도 제한 및 잠재적 오류를 이해하세요. 키당 분당 300개 요청 및 8개의 동시 요청으로 제한됩니다. 요청 본문 크기는 8MB로 제한됩니다. 이러한 제한을 초과하면 429 오류가 발생합니다. 이를 원활하게 처리하기 위해 지수 백오프를 구현할 수 있습니다.

자주 발생하는 오류에는 키가 잘못되어 401, 크레딧 부족으로 402가 포함됩니다. 크레딧이 고갈되면 계속하려면 암호화폐로만 충전해야 합니다. 오류와 거절은 무료이므로 실패한 요청에 대해 지불하지 않습니다. 모델은 미성년자와 관련된 성 콘텐츠만 하드 제한으로 거부합니다.

GET /v1/models 엔드포인트를 통해 사용 가능한 모델을 확인할 수 있습니다. 이는 단일 uncensored 모델 ID를 반환합니다. 여러 모델이나 라우팅을 제공하지 않습니다. 이러한 단순성은 복잡성을 줄이고 일관된 동작을 보장합니다. 선불 크레딧은 만료되지 않으므로 사용 중단을 해도 자금을 잃지 않습니다.

cURL

Copycurl https://api.keyapiunlimited.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list the python libraries for web scraping"}]
  }'

Python

Copyfrom openai import OpenAI

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