5분 내 첫 요청

베이스 URL 및 인증

당사의 API는 OpenAI v1 인터페이스를 그대로 따르므로 애플리케이션 로직을 변경하지 않고도 엔드포인트를 교체할 수 있습니다. 기본 URL로 https://api.groknsfw.top/v1를 사용하십시오. 인증은 Authorization 헤더에 Bearer 토큰 형식으로 유효한 API 키를 전달해야 합니다. 이 키는 대시보드에서 Google 로그인 또는 이메일을 통해 즉시 생성할 수 있습니다. 각 계정당 동시에 활성화된 키는 하나만 지원되며, 새 키를 발급하면 이전 키가 즉시 무효화됩니다. 이러한 단일 키 모델은 대부분의 개발 및 QA 환경에서 접근 제어를 단순화합니다.

첫 번째 요청

연결성을 테스트하려면 표준 채팅 완료 요청을 보내세요. 모델 식별자는 uncensored이며, 이 모델은 콘텐츠 거부 처리 방식이 일반 모델과 다릅니다. 아래는 curl 명령줄 도구를 사용하여 키와 베이스 URL이 올바른지 확인하는 기본 예제입니다.

Copycurl https://api.groknsfw.top/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."}]
  }'

choices 및 usage가 포함된 JSON 응답을 받으면 연동이 활성화된 것입니다. 정확한 청구 추적을 위해 usage 객체를 확인하여 토큰 소비량을 확인하세요.

Python SDK 연동

당사 엔드포인트와 상호 작용하려면 공식 openai Python 패키지를 사용하세요. 호출 전에 base_url 및 api_key 속성을 설정하세요. 이 방식은 OpenAI 스키마를 지원하는 모든 라이브러리에서 작동하므로 다른 제공업체로의 마이그레이션이 간편합니다.

Copyfrom openai import OpenAI

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

이 코드 스니펫은 동기식 요청을 보여줍니다. 높은 처리량의 NSFW 콘텐츠 생성의 경우, 메인 스레드를 차단하지 않고 여러 요청을 동시에 처리할 수 있는 비동기식 클라이언트를 사용하는 것을 고려하세요.

Node.js SDK 설정

JavaScript 또는 TypeScript 애플리케이션의 경우 OpenAI SDK를 당사 베이스 URL을 가리키도록 구성하세요. 이렇게 하면 기존 클라이언트 코드를 수정하지 않고도 작동합니다. Node.js 생태계는 이 호환성 덕분에 NSFW 채팅 인터페이스의 신속한 프로토타이핑에 이점을 얻습니다.

Copyimport OpenAI from "openai";

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

사용자 정의 베이스 URL을 지원하는 최신 버전의 SDK를 사용하고 있는지 확인하세요. 구성 객체에는 엔드포인트 불일치를 피하기 위해 apiKey 및 baseURL 속성을 엄격히 포함해야 합니다.

스트리밍 응답 (SSE)

요청에 stream: true를 설정하여 실시간 토큰 생성을 활성화하세요. API는 SSE 스트림을 반환하여 생성된 토큰을 즉시 제공합니다. 이는 채팅 애플리케이션에서 사용자가 느끼는 지연 시간을 줄여줍니다.

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)

SSE 이벤트를 구문 분석하여 delta 콘텐츠를 추출하세요. 스트림의 마지막 청크에는 총 usage 통계가 포함되어 있으며, 이를 정확한 청구 정산을 위해 사용해야 합니다. 스트리밍은 토큰 카운팅이나 가격 책정에 영향을 미치지 않습니다.

제한, 오류 및 컨텍스트

요청에는 분당 300회, 키당 동시 요청 8회라는 제한이 적용됩니다. 최대 요청 본문 크기는 8 MB이며, 컨텍스트 창은 총 100,000개의 토큰을 지원합니다. 오류는 표준 HTTP 형식으로 반환됩니다: 키가 유효하지 않으면 401, 크레딧이 부족하면 402, 속도 제한에 도달하면 429가 반환됩니다. 크레딧 관련 오류는 요금이 부과되지 않지만, 속도 제한에 도달하면 요청 속도를 줄여야 합니다. 요청당 최대 출력은 32,000개 토큰이며, max_tokens을 생략하면 2,048개 토큰이 기본값으로 적용됩니다.