OpenRouter AI 키: 빠른 시작 가이드

Base URL & 인증

API 키는 모든 요청을 인증합니다. 엔드포인트를 사용하려면 기본 URL https://api.openrouteraikeys.com/v1 키를 Authorization header. 이 설정은 표준 인증 패턴을 따르는 모든 OpenAI 호환 SDK와 호환됩니다. 클라이언트 라이브러리를 수정할 필요 없이 베이스 URL 구성만 변경하면 됩니다.

• 헤더: Authorization: Bearer YOUR_API_KEY
• Base URL: https://api.openrouteraikeys.com/v1

첫 번째 요청

연결성 및 응답 형식을 테스트하려면 표준 채팅 완료 요청을 보내세요. 모델 ID는 uncensored 표준 메시지 배열을 허용합니다. 이 엔드포인트는 텍스트만 반환하므로 응답 페이로드에 이미지나 오디오 데이터가 포함되지 않음을 예상하지 마세요.

Copycurl https://api.openrouteraikeys.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "messages": [{"role": "user", "content": "Summarize this documentation page"}]
  }'

Python SDK 통합

사용자 지정 기본 URL과 키로 클라이언트를 초기화합니다. 이를 통해 익숙한 chat.completions.create 추가 로직을 래핑하지 않고 메서드. 라이브러리는 직렬화 및 재시도 로직을 자동으로 처리합니다.

Copyfrom openai import OpenAI

client = OpenAI(base_url="https://api.openrouteraikeys.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 SDK 통합

구성 OPENAI_API_KEY 및 OPENAI_BASE_URL 환경 변수 또는 클라이언트 생성자에 직접 전달합니다. 이렇게 하면 모든 후속 호출이 당사 비검열 엔드포인트로 라우팅됩니다. 이미 설치된 동일한 SDK 버전을 계속 사용할 수 있습니다.

Copyimport OpenAI from "openai";

const client = new OpenAI({ baseURL: "https://api.openrouteraikeys.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을 true로 설정하여 스트리밍 활성화 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)

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

컨텍스트 창은 프롬프트와 완료를 합해 총 100,000개의 토큰을 지원합니다. 키당 분당 요청 수는 300개로 제한됩니다. 401 오류는 API 키가 유효하지 않거나 누락되었음을 의미합니다. 402 오류는 선불 크레딧이 부족함을 나타냅니다. 429 오류는 속도 제한을 초과했음을 신호합니다. 콘텐츠 정책으로 인한 거부는 무료이지만, 계산 오류는 토큰을 소모할 수 있습니다.