빠른 시작: 몇 분 만에 통합하기

1. SDK 설치하기

언어용 공식 라이브러리를 설치하세요. 대부분의 개발자는 이미 알고 있는 인터페이스와 일치하는 표준 패키지를 선호합니다. 다음을 실행하세요. pip install openai Python 또는 npm install openai Node.js용입니다. 모든 요청을 처리하기 위해 하나의 SDK만 필요합니다.

2. Base URL 설정

클라이언트를 우리 특정 엔드포인트로 연결하세요. 트래픽을 올바르게 라우팅하려면 기본 base URL을 재정의해야 합니다. 사용 https://api.unsencoredai.com/v1 베이스 URL로 사용합니다. API 키를 Authorization header. 이 설정은 모든 표준 OpenAI 호환 클라이언트와 호환됩니다.

Copyfrom openai import OpenAI

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

Copyimport OpenAI from "openai";

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

3. 첫 번째 요청 보내기

텍스트를 생성하려면 표준 채팅 완료 요청을 보내세요. 모델 ID는 uncensored. 동작을 안내하기 위해 시스템 프롬프트를 보낼 수 있습니다. API는 직접적인 텍스트 응답을 반환합니다. 연결성을 즉시 테스트하려면 아래 curl 명령어를 사용하십시오. 응답에서 다음을 확인하십시오. choices 배열입니다.

Copycurl https://api.unsencoredai.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "what is the version number"}]
  }'

4. 스트리밍 응답 처리하기

낮은 지연 시간과 실시간 출력을 위해 스트리밍을 활성화하세요. 설정 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)

5. 파라미터 구성하기

조정 temperature, top_p, 그리고 stop 시퀀스. 이러한 제어는 창의성과 출력 길이에 영향을 미칩니다. 또한 response_format JSON 모드를 위한 것입니다. 컨텍스트 창은 총 100,000개의 토큰을 지원합니다. 요청당 최대 출력은 16,000개의 토큰입니다. 특정 사용 사례에 맞게 이러한 설정을 미세 조정하십시오.

6. 한계, 오류 및 컨텍스트

표준 HTTP 상태 코드를 사용하여 오류를 우아하게 처리하세요. 401 오류는 API 키가 유효하지 않음을 의미합니다. 402 오류는 선불 크레딧이 부족함을 나타냅니다. 429 오류는 분당 300회 요청 한도에 도달했음을 신호합니다. 컨텍스트 윈도우는 100,000 토큰입니다. 8MB를 초과하는 요청은 실패할 수 있습니다. 크레딧에 대한 환불은 제공되지 않지만 오류는 무료입니다.