Uncensored API 빠른 시작 가이드

인증 및 Base URL

SDK를 당사 기본 URL에 연결하고 인증 헤더에 키를 전달하세요. 당사는 프록시 라우팅 수수료 없는 직접 단일 모델 서비스를 제공합니다. 표준 Authorization: Bearer 요청을 인증하는 스키마입니다. 키는 Google 또는 이메일로 가입한 직후 생성됩니다. 클라이언트 구성의 자리 표시자 키를 대시보드에 표시된 키로 교체하세요. 베이스 URL은 https://api.uncensoredmodelsollama.com/v1. 이 엔드포인트는 표준 OpenAI 호환 클라이언트를 지원하여 애플리케이션 로직을 다시 작성하지 않고도 공급자를 전환할 수 있습니다. 선불 크레딧 잔액에 대한 접근 권한을 부여하므로 키를 안전하게 보관하십시오.

채팅 완료 엔드포인트

에 텍스트 요청을 보내세요 /v1/chat/completions 응답을 생성하는 엔드포인트입니다. 이 엔드포인트는 표준 대화 기록과 시스템 프롬프트를 처리합니다. 모델 ID를 uncensored 요청 본문에서. API는 생성된 텍스트와 토큰 사용량 통계를 포함하는 JSON 형식의 응답을 반환합니다. 크레딧 부족 또는 유효하지 않은 키와 같은 오류는 적절한 HTTP 상태 코드와 함께 반환됩니다. 이 엔드포인트는 모든 표준 텍스트 생성 작업에 사용하십시오. 임베딩, 이미지 또는 파인튜닝은 지원되지 않습니다. 신뢰할 수 있는 처리를 위해 페이로드를 8 MB 미만으로 유지하십시오. 모델은 공유 컨텍스트 창 내에서 입력 및 출력 토큰을 처리합니다.

스트리밍 응답

스트리밍을 활성화하려면 stream 요청에서 true로 설정하세요. API는 텍스트의 증분 청크를 포함하는 서버 전송 이벤트(SSE)를 반환합니다. 이 접근 방식은 긴 출력을 기다리는 사용자의 지각된 지연 시간을 줄입니다. 스트림의 마지막 청크에서 토큰 사용 정보를 받습니다. 클라이언트에서 이러한 이벤트를 효율적으로 처리하기 위해 스트림 핸들러를 구현하세요. 스트리밍은 채팅 인터페이스 및 실시간 애플리케이션에 이상적입니다. 지속적인 데이터 흐름을 올바르게 처리하려면 클라이언트 라이브러리가 SSE 구문 분석을 지원해야 합니다. 전체 컨텍스트 창은 스트리밍 모드와 관계없이 100,000 토큰으로 유지됩니다.

함수 호출 및 JSON 모드

을 사용하세요 tools 함수 호출 기능을 활성화합니다. 요청 본문에 함수를 정의하여 모델이 구조화된 데이터를 반환하도록 합니다. 설정 response_format 수신하여 {"type": "json_object"} 엄격한 JSON 출력을 위해 이 기능은 데이터 추출 또는 구조화된 페이로드 생성에 유용합니다. 모델은 함수 호출 동작을 제어하기 위한 도구 선택 매개변수를 지원합니다. 이러한 기능을 사용하여 API를 자동화 워크플로우에 통합하세요. 신뢰할 수 있는 결과를 얻으려면 함수 정의가 예상 입력 스키마와 일치하는지 확인하세요. API는 표준 OpenAI 형식으로 도구 호출을 반환하여 쉽게 파싱할 수 있습니다.

매개변수 및 속도 제한

다음 매개변수를 사용하여 생성 동작을 조정합니다. temperature, top_p, 그리고 seed설정 max_tokens 출력 길이를 제한하며, 지정되지 않은 경우 기본값은 2,048입니다. API는 키당 분당 300개의 요청에 대한 속도 제한을 적용합니다. 키당 동시 요청은 8개로 제한됩니다. 이러한 제한을 초과하면 API는 429 상태 코드를 반환합니다. 요청은 실제 토큰 사용량을 기준으로 청구되며, 오류와 거부는 무료입니다. 크레딧은 만료되지 않으며, 선불 금액은 투명합니다. 각 계정은 활성 키를 하나만 지원하므로 키를 신중하게 관리하세요.

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

컨텍스트 윈도우는 입력과 출력을 합쳐 100,000개의 토큰을 지원합니다. 8 MB 본문 제한을 초과하는 요청은 실패합니다. 일반적인 오류로는 유효하지 않은 키에 대한 401과 부족해진 크레딧에 대한 402가 있습니다. 이러한 오류는 애플리케이션 로직에서 우아하게 처리하십시오. API는 다른 설정과 관계없이 미성년자가 포함된 성적인 콘텐츠가 있는 요청을 거부합니다. 기타 콘텐츠는 합법적인 성인 용도로 비검열 상태입니다. 예상치 못한 과금을 피하기 위해 토큰 사용량을 모니터링하십시오. 선불 크레딧 시스템은 사용량만큼만 지불하도록 보장합니다. 구독료나 숨겨진 비용이 적용되지 않습니다.

cURL

Copycurl https://api.uncensoredmodelsollama.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List all available models in the ollama library."}]
  }'

Python

Copyfrom openai import OpenAI

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