OpenRouter 사용자를 위한 빠른 시작

설치 및 설정

당사의 API는 표준 OpenAI SDK와 완전히 호환됩니다. OpenRouter에서 전환하려면 base_url 및 api_key 두 가지 구성 값만 업데이트하면 됩니다. 클라이언트를 https://api.openrouterapi.cc/v1로 지정하고 대시보드에서 생성한 키를 사용하십시오. 사용자 정의 헤더나 복잡한 라우팅 로직이 필요하지 않습니다. 요청할 모델 ID는 uncensored입니다.

SDK 버전이 base_url 매개변수를 지원하는지 확인하세요. 원시 HTTP 클라이언트를 사용하는 경우 대상 URL을 직접 업데이트하면 됩니다. 이 설정은 텍스트 완성 요청만 전송하는 한 기존 클라이언트 코드를 수정하지 않고 작동하게 합니다.

인증

인증은 표준 Authorization 헤더를 통해 처리됩니다. API 키를 Bearer 토큰으로 전달하세요. 키가 유효하지 않거나 만료된 경우 API는 401 오류를 반환합니다. 일부 제공업체와 달리 우리는 실패한 요청에 대해 요금을 부과하지 않습니다. 오류와 거절은 무료이므로 크레딧을 소모하지 않고 인증을 테스트할 수 있습니다.

각 계정은 동시에 하나의 활성 키만 지원합니다. 새 키를 생성하면 이전 키가 즉시 무효화됩니다. 키를 안전하게 보관하고 노출이 의심될 경우 교체하세요. 키는 가입 직후 표시되므로 페이지를 떠나기 전에 복사하세요.

기본 채팅 완료

핵심 기능은 POST /v1/chat/completions 엔드포인트입니다. 프롬프트를 메시지 목록으로 보내고 텍스트 응답을 받으세요. 이 모델은 합법적인 성인 사용에 대해 콘텐츠 거부 없이 답변하도록 조정되어 창의적, 논쟁적 또는 보안 연구 주제에 적합합니다.

model 필드를 uncensored로 설정하세요. temperature, top_p, stop 등의 매개변수를 사용하여 동작을 제어할 수 있습니다. API는 response_format을 통해 JSON 모드를 지원하고 tools을 통해 함수 호출을 지원합니다. 모든 요청은 비동기로 처리되며 모델이 완료할 때 전체 완성을 받습니다.

스트리밍 응답

요청에 stream: true을 설정하여 스트리밍을 활성화하세요. API는 부분 응답을 포함한 서버 전송 이벤트(SSE)를 반환합니다. 텍스트 청크가 생성되는 대로 수신하여 애플리케이션에서 실시간으로 표시할 수 있습니다.

토큰 사용량 정보는 스트림의 마지막 청크에서 제공됩니다. 이를 통해 개별 토큰을 모두 구문 분석하지 않고도 비용을 정확하게 추적할 수 있습니다. 스트리밍은 지연 시간이 중요한 채팅 인터페이스에 이상적입니다. 클라이언트가 SSE를 올바르게 처리하고 스트림이 종료될 때 연결을 종료하는지 확인하세요.

함수 호출

API는 tools 매개변수를 통해 함수 호출을 지원합니다. tools 배열에 함수를 정의하고 tool_choice을 auto 또는 특정 함수 이름으로 설정하세요. 함수가 트리거되면 모델이 구조화된 JSON 인수를 반환합니다.

이 기능은 LLM을 외부 API나 데이터베이스와 통합하는 데 유용합니다. 모델이 유효한 인수를 생성하는 데 의존하므로 함수 정의가 정확한지 확인하세요. API는 함수를 실행하지 않으므로 실행 로직을 애플리케이션 코드에서 처리해야 합니다.

JSON 모드

구조화된 출력이 필요한 경우 response_format: {"type": "json_object"}을 사용하세요. 이는 하류 애플리케이션에서 데이터 구문 분석에 필수적인 유효한 JSON을 반환하도록 모델을 강제합니다. JSON 모드는 단순한 데이터 추출 작업에서 함수 호출보다 종종 더 신뢰할 수 있습니다.

프롬프트가 JSON을 반환하도록 모델을 명확하게 지시하는지 확인하세요. 프롬프트가 모호하면 유효하지 않은 JSON 응답이 발생할 수 있습니다. JSON 모드는 표준 모드와 스트리밍 모드 모두에서 지원됩니다. 예측 가능하고 기계 판독 가능한 출력이 필요할 때 사용하세요.

제한, 오류 및 컨텍스트

컨텍스트 창은 프롬프트와 완료를 합쳐 100,000 토큰입니다. 최대 출력은 요청당 32,000 토큰입니다 (max_tokens이 설정되지 않은 경우 2,048). 속도 제한은 분당 300개 요청 및 키당 8개의 동시 요청입니다. 요청 본문은 8 MB로 제한됩니다.

오류는 표준 HTTP 코드를 반환합니다: 키가 유효하지 않으면 401, 크레딧이 부족하면 402, 속도 제한이 초과되면 429입니다. 크레딧은 선불이므로 402 오류는 충전이 필요함을 의미합니다. 오류와 거부는 무료이므로 비용 없이 다시 시도할 수 있습니다. 콘텐츠 제한은 미성년자가 포함된 성적인 콘텐츠를 차단합니다.

cURL

Copycurl https://api.openrouterapi.cc/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

Copyfrom openai import OpenAI

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

Node.js

Copyimport OpenAI from "openai";

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

스트리밍

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)