Ollama NSFW 사용자를 위한 빠른 시작

사전 준비 및 인증

시작하려면 API 키와 Base URL이 필요합니다. Google 또는 이메일로 API 키 받기 페이지에서 가입하세요. 키는 즉시 발급되며 체험용에는 카드가 필요하지 않습니다. Base URL은 https://api.ollamansfw.com/v1입니다. 환경 변수나 SDK 구성에 설정하세요. 모델 식별자는 uncensored입니다. 이는 GPT나 기타 벤더 모델과 구분되는 오픈 웨이트 모델로, 당사 서버에서 실행됩니다.

첫 번째 요청

표준 채팅 완성 요청을 보내세요. API는 role과 content가 있는 messages 배열을 기대합니다. curl로 연결 상태를 테스트하세요. YOUR_API_KEY을 실제 키로 바꿉니다. 응답은 choices[0].message.content에 생성된 텍스트를 반환합니다. 401이 발생하면 키를 확인하세요. 402는 크레딧이 필요함을 의미합니다.

Python SDK 통합

공식 openai Python 패키지를 사용하세요. pip를 통해 설치하세요. 사용자 지정 Base URL과 API 키로 클라이언트를 초기 설정하세요. 이는 엔드포인트와의 호환성을 보장합니다. 아래 코드는 간단한 텍스트 생성을 보여줍니다. 요청을 처리하고 결과를 출력합니다. 오류 처리는 HTTP 예외를 캐치해야 합니다. 이 접근 방식은 모든 OpenAI 호환 클라이언트에 적용됩니다.

Node.js SDK 통합

openai Node.js 패키지를 설치하세요. 클라이언트 초기 설정 시 Base URL과 API 키를 설정하세요. 구조는 Python 예제와 동일합니다. 모델 ID uncensored를 전달하세요. 응답에는 완성 데이터가 포함됩니다. 깔끔한 코드를 위해 async/await를 사용하세요. 이 방법은 직접 API 접근이 필요한 서버 측 애플리케이션이나 CLI 도구에 이상적입니다.

스트리밍 응답

stream: true를 설정하여 스트리밍을 활성화하세요. API는 서버 푸시 이벤트(SSE) 스트림을 반환합니다. 각 청크에는 부분 텍스트가 포함됩니다. 마지막 청크에는 토큰 사용 통계가 포함됩니다. 이는 긴 응답의 지각된 지연 시간을 줄입니다. 스트림 오류를 부드럽게 처리하세요. SDK에는 내장 스트림 반복자가 제공됩니다. 각 청크를 처리하여 UI를 실시간으로 업데이트하세요.

제한, 오류 및 컨텍스트

컨텍스트 창은 총 100,000 토큰입니다. 출력은 창의 끝까지 이어질 수 있습니다. 속도 제한은 분당 300 요청입니다. 동시 요청은 키당 최대 8개로 제한됩니다. 요청 본문은 8 MB 미만이어야 합니다. 일반 오류: 401(잘못된 키), 402(부족한 크레딧), 429(속도 제한). 오류는 크레딧을 소모하지 않습니다. 불법 콘텐츠에 대한 거부는 무료입니다. 크레딧은 만료되지 않습니다.

cURL

복사curl https://api.ollamansfw.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Write a blunt product review of a cheap VPN."}]
  }'

Python

복사from openai import OpenAI

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

복사import OpenAI from "openai";

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