빠른 시작: 무검열 API 통합하기

필수 조건 및 SDK 설치

API는 유효한 API 키와 최신 SDK가 필요합니다. 선호하는 언어용 라이브러리를 pip 또는 npm을 통해 설치하세요. 당사는 인증 및 JSON 파싱을 자동으로 처리하는 표준 OpenAI 클라이언트 라이브러리를 지원합니다.

Python 3.8+ 또는 Node.js 18+이 설치되어 있는지 확인하세요. SDK는 연결 풀링 및 재시도 로직을 관리하므로 보일러플레이트 코드가 크게 줄어듭니다.

Copyfrom openai import OpenAI

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

베이스 URL 및 API 키 구성

클라이언트를 저희 특정 엔드포인트로 연결하세요. 대시보드에서 제공된 베이스 URL을 사용하세요. API 키를 Authorization 헤더에 전달하세요. 이를 통해 요청이 uncensored 인프라에 직접 도달하도록 보장합니다.

기본 OpenAI 기본 URL을 사용하지 마세요. 잘못 라우팅되면 키가 실패합니다. 데이터 전송 전에 SDK 구성 객체에서 기본 URL을 설정하세요.

Copycurl https://api.ablatedmodels.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Send me the monthly server uptime report"}]
  }'

첫 번째 채팅 완료 요청 전송

/v1/chat/completions으로 POST 요청을 전송하세요. 모델 ID와 messages 배열을 포함하세요. 모델은 즉시 텍스트 콘텐츠로 응답합니다. 복잡한 라우팅 로직이 필요하지 않습니다.

페이로드는 간단하게 유지하세요. 단일 시스템 프롬프트와 하나의 사용자 메시지로 시작하세요. 응답 구조가 OpenAI 표준과 일치하는지 확인하세요. 이렇게 하면 통합이 올바르게 작동하는지 확인할 수 있습니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.ablatedmodels.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는 서버 전송 이벤트를 통해 청크를 반환합니다. 각 청크에는 부분 텍스트 또는 토큰 사용량 데이터가 포함됩니다. 이러한 청크를 집계하여 실시간 출력을 표시하세요.

함수 호출을 위해 툴 사용이 지원됩니다. 요청에서 툴을 정의합니다. 모델은 적절한 경우 일반 텍스트 대신 툴 호출을 반환합니다. 툴 호출을 구문 분석하여 사용자 정의 로직을 실행합니다.

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)

토큰 제한 및 컨텍스트 윈도우 이해하기

컨텍스트 창은 총 100,000개의 토큰을 지원합니다. 여기에는 입력 및 출력 토큰이 모두 포함됩니다. 응답 길이를 제한하려면 max_tokens를 설정하세요. 미지정 시 기본 최대 출력은 2,048개 토큰입니다.

오류는 크레딧을 소모하지 않으므로 스트리밍 마지막 청크에서 토큰 사용량을 모니터링하세요. 이는 재정적 위험 없이 안전한 실험을 가능하게 합니다. 프롬프트 구조를 한도 내에 있도록 계획하세요.

일반적인 오류トラブルシュー팅

먼저 API 키를 확인하세요. 401 오류는 유효하지 않거나 만료된 키를 나타냅니다. 402 오류는 선불 크레딧이 고갈되었음을 의미합니다. 계속하려면 암호화폐로 충전하세요.

429 오류는 속도 제한을 나타냅니다. 분당 300개 요청으로 제한됩니다. 동시성을 줄이거나 다시 시도하기 전에 기다리세요. 8 MB 본문 제한도 초과할 경우 400 오류를 트리거합니다.