OpenAI-Compatible API 문서
표준 OpenAI 클라이언트 코드를 사용하여 몇 분 안에 제한 없는 API로 시작하세요. 이 가이드에서는 "제한 없는" 모델의 인증, 요청, 스트리밍 및 제한 사항을 다룹니다.
Base URL 및 인증
모든 요청은 다음을 설정하여 시작하세요 base_url 수신하여 https://api.nsfwgemma.com/v1 API 키를 Authorization 헤더. Google 또는 이메일로 가입하면 즉시 키를 받으며, 전화번호가 필요하지 않습니다. 서비스에 접근하는 데 필요한 유일한 자격 증명인 만큼 이 키를 안전하게 보관하세요.
POST /v1/chat/completions: 매개변수 및 예시
표준 채팅 completion 형식을 사용하여 엔드포인트에 첫 번째 메시지를 보내세요. 모델 ID는 항상 "uncensored"이며, temperature 및 top_p과 같은 매개변수를 통해 출력 스타일을 제어할 수 있습니다. 이 엔드포인트는 복잡한 로컬 설정 없이 모든 텍스트 생성을 처리합니다.
curl https://api.nsfwgemma.com/v1/chat/completions \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "uncensored",
"messages": [{"role": "user", "content": "List the top ten system prompts for the model"}]
}'
페이로드에 model field set to "uncensored" and a messages 프롬프트를 포함하는 배열입니다. 시스템은 생성된 텍스트를 포함한 구조화된 JSON 응답을 반환합니다.
GET /v1/models: 사용 가능한 모델 나열
사용 가능한 인스턴스를 확인하고 연결을 확인하기 위해 모델 엔드포인트를 쿼리합니다. 이 GET 요청은 현재 모델 구성에 대한 메타데이터를 반환하며 크레딧을 소모하지 않습니다. 비싼 생성 요청을 전송하기 전에 연결 문제를 디버깅하는 데 사용하세요.
from openai import OpenAI
client = OpenAI(base_url="https://api.nsfwgemma.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)
응답은 모델 ID와 토큰 제한을 확인하여 클라이언트가 uncensored 대규모 언어 모델에 맞게 올바르게 구성되었음을 보장합니다.
SSE를 사용한 스트리밍 응답
stream을 true로 설정하여 스트리밍 활성화 stream: true 서버 전송 이벤트(Server-Sent Events)를 통해 토큰을 실시간으로 수신합니다. 이는 장문 창작 글쓰기나 역할극 시나리오에서 지각된 지연 시간을 줄여줍니다. 토큰 사용 통계는 스트림의 마지막 청크에 포함됩니다.
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)
델타 객체를 파싱하여 텍스트를 단계적으로 렌더링하여 대화형 NSFW 채팅봇 애플리케이션에 더 부드러운 사용자 경험을 제공하세요.
오류 처리 및 토큰 사용량
일반적인 HTTP 오류를 우아하게 처리하세요: 401은 유효하지 않거나 만료된 키를 나타내고, 402는 크레딧을 충전해야 함을 의미하며, 429는 속도 제한 고갈을 나타냅니다. 오류는 사전 지불 크레딧을 소모하지 않으므로 페널티 없이 재시도할 수 있습니다. 항상 확인하세요 usage field in successful responses to track consumption.
속도 제한 및 동시성
각 API 키는 분당 300회 요청과 최대 8개의 활성 동시 요청을 지원합니다. 최대 요청 본문 크기는 8MB로, 대부분의 표준 컨텍스트 윈도우에 맞습니다. 이러한 한도를 초과하면 윈도우가 초기화될 때까지 429 오류가 발생합니다.
컨텍스트 윈도우는 프롬프트와 completion을 합쳐 총 100,000개의 토큰을 허용합니다. 최대 출력은 요청당 16,000개 토큰이며, 지정하지 않을 경우 2,048개 토큰입니다. max_tokens애플리케이션의 트래픽 패턴에 따라 동시성을 조정하세요.
지원되는 파라미터: Temperature, Top P 등
무작위성과 결정론적 성향을 temperature, top_p, stop, seed, 그리고 패널티 매개변수. 사용 response_format 설정 {"type": "json_object"} 구조화된 데이터 출력을 위해. 함수 호출은 tools 고급 통합을 위한 매개변수입니다.
이 파라미터들은 Uncensored 모델의 동작을 미세 조정하여 예상치 못한 거부 반응 없이 특정 NSFW 콘텐츠 요구 사항에 맞게 조정합니다.
Node.js
import OpenAI from "openai";
const client = new OpenAI({ baseURL: "https://api.nsfwgemma.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);자주 묻는 질문
NSFW API의 베이스 URL은 무엇인가요?
기본 URL은 HTTPS://api.nsfwgemma.com/v1입니다. 이 주소로 SDK를 가리키고 API 키를 제공하여 모든 표준 OpenAI 호환 SDK를 사용할 수 있습니다.
컨텍스트 윈도우는 어떻게 작동하나요?
이 모델은 프롬프트와 응답의 합계 기준 100,000개의 토큰 컨텍스트 윈도우를 지원합니다. 요청당 최대 16,000개 토큰까지 생성할 수 있으며, max_tokens을 설정하지 않으면 2,048개입니다.
402 오류가 발생하면 어떻게 되나요?
402 오류는 사전 결제된 크레딧이 소진되었음을 의미합니다. 오류는 크레딧을 소모하지 않으므로 크립토로 충전하고 사용량 손실 없이 다시 시도할 수 있습니다. 크레딧은 만료되지 않습니다.