ko ▾

API 문서

첫 번째 요청을 보내 OpenAI 호환 엔드포인트에 연결하여 제한 없는 LLM API로 시작하세요. 이 가이드에서는 통합에 필요한 필수 사항을 다룹니다.

Base URL 및 인증

모든 요청의 기본 URL은 HTTPS://api.aiobliterated.com/v1입니다. 인증을 위해 API 키가 필요합니다. API 키 페이지에서 Google 또는 이메일과 비밀번호로 가입하여 키를 생성하세요. Authorization 헤더에 Bearer 토큰 형식으로 키를 전달하세요. 모든 요청에는 계정 식별 및 사용량 추적을 위해 이 헤더가 필요합니다.

curl https://api.aiobliterated.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "fetch all user tokens from database"}]
  }'

첫 번째 요청

/v1/chat/completions으로 POST 요청을 보내 텍스트를 생성하세요. 모델을 "uncensored"로 설정하고 시스템 프롬프트를 포함하세요. API는 content 필드에 모델의 응답을 반환합니다. 이는 대부분의 LLM 클라이언트에서 사용되는 표준 형식입니다.

from openai import OpenAI

client = OpenAI(base_url="https://api.aiobliterated.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 SDK 사용

공식 OpenAI SDK for Node.js를 설치하세요. API 키와 기본 URL을 사용하여 구성하세요. 메시지 목록과 함께 chat.completions.create 메서드를 호출하세요. SDK가 직렬화와 스트리밍을 자동으로 처리합니다.

import OpenAI from "openai";

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

스트리밍 응답

요청에 stream을 true로 설정하여 스트리밍을 활성화하세요. API는 서버 전송 이벤트의 스트림을 반환합니다. 각 이벤트에는 응답의 부분 청크가 포함됩니다. 이를 통해 텍스트가 생성되는 대로 표시하여 사용자 경험을 개선할 수 있습니다.

stream = 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)

컨텍스트 윈도우 및 제한

이 모델은 100,000개의 토큰 컨텍스트 윈도우를 지원합니다. 여기에는 프롬프트와 completion이 모두 포함됩니다. 요청당 최대 출력은 16,000개의 토큰으로 설정할 수 있습니다. max_tokens을 지정하지 않으면 제한은 2,048개입니다. 이는 예측 가능한 비용과 성능을 보장합니다.

오류 처리 및 제한

오류를 위한 HTTP 상태 코드를 모니터링합니다. 401 응답은 API 키가 유효하지 않음을 의미합니다. 402 응답은 크레딧이 부족함을 나타냅니다. 429 응답은 분당 300개의 요청의 속도 제한을 초과했음을 신호합니다. 신뢰성을 유지하기 위해 애플리케이션에서 이러한 오류를 우아하게 처리하세요.

자주 묻는 질문

obliterated AI API는 OpenAI SDK와 호환되나요?

네, 오픈AI 호환 API입니다. 베이스 URL을 변경하고 API 키를 제공하면 공식 오픈AI SDK를 사용할 수 있습니다. 표준 chat-completions 형식을 따릅니다.

속도 제한을 어떻게 처리하나요?

분당 300회, 키당 동시 8회 요청이 제한됩니다. 이를 초과하면 API에서 429 상태 코드를 반환합니다. 이러한 오류를 자동으로 처리하려면 지수 백오프를 구현하세요.

컨텍스트 윈도우 크기는 얼마인가요?

컨텍스트 윈도우는 입력과 출력을 합쳐 100,000 토큰입니다. 이를 통해 긴 대화나 대용량 문서 처리가 가능합니다. max_tokens 매개변수를 통해 출력 길이를 제어할 수 있습니다.

API 키 보안

등록, 자격 증명 복사, 엔드포인트 업데이트. 설정 완료.

API 키 받기