빠른 시작: 통합하기 Uncensored API

필수 조건: SDK 및 환경 설정

언어별 공식 SDK를 지원합니다. openai 호환 클라이언트. 당사 서비스는 표준 OpenAI 통합의 교체 가능한 대체재 역할을 합니다.

환경 변수를 즉시 설정하세요. 이렇게 하면 소스 파일에 자격 증명을 하드코딩하는 것을 피할 수 있습니다. API 키는 계정 식별과 사용량 추적을 담당합니다.

표준 라이브러리 버전을 사용하세요. 대부분의 개발자는 이미 이 라이브러리들이 설치되어 있습니다. 설치되어 있지 않다면 패키지를 의존성 목록에 추가하세요.

인증: API 키 설정

를 통해 키를 전달하세요 Authorization header. 모든 요청에 Bearer 토큰이 필요합니다. 이 방식은 모든 OpenAI 호환 엔드포인트에서 표준입니다.

대시보드에서 키를 생성하세요. 계정당 활성 키가 하나 제공됩니다. 키를 교체하면 이전 키가 즉시 무효화됩니다.

키는 안전하게 보관하세요. 클라이언트 측 코드에 노출하지 마세요. 엔드포인트는 토큰 처리 전에 자격 증명을 검증합니다.

엔드포인트: POST /v1/chat/completions

chat 엔드포인트로 프롬프트를 전송하세요. 다음을 사용하세요 model field set to uncensored요청이 특정 모델로 라우팅됨을 보장합니다.

SSE를 통한 스트리밍 응답

stream을 true로 설정하여 스트리밍 활성화 stream: true생성되는 대로 청크를 받게 됩니다. 이는 긴 출력의 지각된 지연 시간을 줄입니다.

Server-Sent Events 형식을 파싱하세요. 각 청크에는 부분 텍스트가 포함됩니다. 이러한 청크를 집계하여 전체 응답을 복원하세요.

마지막 이벤트에는 전체 사용량 통계가 포함되므로 마지막 청크에서 토큰 사용량을 모니터링하세요. 이는 비용을 정확하게 추적하는 데 도움이 됩니다.

함수 호출 및 도구 사용

요청 본문에 도구를 정의하세요. 모델은 구조화된 인수를 반환합니다. 이러한 인수를 애플리케이션 로직에서 구문 분석하세요.

표준 도구 정의를 지원합니다. 사용 tool_choice 특정 동작을 강제합니다. 이는 모든 OpenAI 호환 SDK와 함께 작동합니다.

출력 형식을 검증합니다. 누락된 인수를 우아하게 처리할 수 있도록 코드를 확인하십시오. 모델은 필요하지 않은 경우 필드를 생략할 수 있습니다.

JSON 모드 및 구조화된 출력

設定 response_format 수신하여 json_object. 모델은 엄격하게 형식화된 JSON을 반환합니다. 이는 구조화된 데이터의 구문 분석 오류를 제거합니다.

스키마를 명확히 정의하세요. 모델은 지시를 정확하게 따릅니다. 데이터 추출이나 구성 생성에 사용하세요.

JSON 파싱 오류를 처리하세요. 잘못된 구조가 가끔 발생할 수 있습니다. 견고한 애플리케이션을 위해 폴백 로직을 구현하세요.

오류 처리 및 속도 제한

HTTP 상태 코드를 적절히 처리하세요. A 401 키가 유효하지 않음을 의미합니다. A 402 크레딧 부족을 나타내는 오류입니다. A 429 rate limiting을 나타냅니다.

분당 300개 요청 제한을 준수하세요. 8개의 동시 요청을 보낼 수 있습니다. 이러한 제한을 초과하면 429 오류가 반환됩니다. 재시도하기 전에 기다리세요.

컨텍스트 윈도우는 프롬프트와 출력을 합쳐 100,000 토큰입니다. 토큰 예산을 신중하게 관리하십시오. 요청당 최대 출력은 16,000 토큰입니다. 오류는 크레딧을 소모하지 않습니다.

cURL

Copycurl https://api.alternativeapiopenai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "List the primary functions in this module"}]
  }'

Python

Copyfrom openai import OpenAI

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