API 문서 & 시작하기

인증 및 Base URL

대시보드에서 API 키를 생성하세요. 표준 OpenAI 호환 헤더를 사용하므로 다음만 업데이트하면 됩니다. base_url 및 API_KEY 변수입니다. 이를 통해 기존 SDK 통합을 수정 없이 작동할 수 있습니다. Google 로그인 또는 이메일/비밀번호 등록을 지원하며, 키는 생성 즉시 표시됩니다.

• Base URL: https://api.routeropen.cc/v1
• Auth Header: Authorization: Bearer YOUR_API_KEY

키는 선불 크레딧을 제어하므로 키를 안전하게 보관하세요. 각 계정에는 동시에 활성 상태인 키가 하나만 지원되며, 새 키를 생성하면 이전 키가 즉시 대체됩니다.

첫 번째 요청

표준을 사용하여 첫 번째 프롬프트를 보내세요 chat/completions 엔드포인트입니다. 모델 ID는 단순히 uncensored. 텍스트를 입력하면 필터 없이 lawful adult 용도로 텍스트가 반환됩니다.

Copycurl https://api.routeropen.cc/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "list all files in current directory"}]
  }'

이 요청은 기본 구조를 보여줍니다. 다음과 같은 매개변수를 조정할 수 있습니다. temperature 또는 top_p 창의성을 제어합니다. 응답에는 투명한 청구를 위한 토큰 사용량 통계가 포함됩니다.

Python SDK 통합

우리 API를 통합하려면 공식 OpenAI Python 라이브러리를 사용하세요. 클라이언트를 우리 기본 URL로 가리키고 API 키를 사용하세요. 이 방법은 이미 OpenAI를 대상으로 하는 기존 코드베이스와 원활하게 작동합니다.

Copyfrom openai import OpenAI

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

라이브러리는 JSON 직렬화 및 스트리밍을 자동으로 처리합니다. 필요에 따라 재시도 로직과 시간 제한을 구성할 수 있습니다. 엔드포인트는 표준 매개변수를 지원하므로 다른 제공업체로의 마이그레이션이 매우 쉽습니다.

Node SDK 통합

For JavaScript developers, the Node SDK works with minimal changes. Set the baseURL 당사 엔드포인트로 설정하고 키를 제공하십시오. 이를 통해 uncensored 모델에 접근하면서도 현재 개발 워크플로우를 유지할 수 있습니다.

Copyimport OpenAI from "openai";

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

Node 사용자는 깔끔한 코드를 위해 async/await 패턴을 활용할 수 있습니다. 응답 구조는 OpenAI 표준과 일치하여 기존 파서와의 호환성을 보장합니다. 두 변수만 변경하여 모델이나 공급자를 전환할 수 있습니다.

스트리밍 응답

stream을 true로 설정하여 스트리밍 활성화 stream: true 요청에 포함됩니다. 실시간 토큰 전달을 위해 서버 전송 이벤트(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 이벤트로 반환되므로 오류를 우아하게 처리할 수 있습니다.

제한 사항, 오류 및 & 컨텍스트

API는 100,000토큰의 컨텍스트 윈도우와 8MB 요청 본문 제한을 적용합니다. 키당 분당 300회 요청을 보낼 수 있습니다. 이를 초과하면 429 속도 제한 오류가 발생합니다. 인증 실패는 401을, 잔액 부족은 402를 반환합니다.

오류는 선불 크레딧이 소모되지 않습니다. 잘못된 형식의 요청을 보내면 요금이 부과되지 않습니다. 모델은 미성년자가 관련된 요청을 거부하지만 그 외에는 제한 없는 콘텐츠를 허용합니다.レート 제한을 효과적으로 관리하기 위해 오류 처리를 견고하게 유지하세요.