빠른 시작
제로에서 작동하는 API 호출까지 약 5분.
UnoRouter 작동 방식
UnoRouter은 OpenAI, Anthropic, Google, DeepSeek, Qwen 및 50개 이상의 다른 제공업체의 200개 이상의 모델을 하나의 OpenAI 호환 엔드포인트 뒤에 배치합니다. 한 번 통합한 후에는 문자열 하나만 바꿔서 모델을 교체하세요. 많은 모델이 완전히 무료이며 신용카드가 필요하지 않습니다.
API를 완전히 건너뛸 수도 있습니다. 내장 채팅은 가입 없이 무료 모델을 실행하며 대화는 브라우저에 남습니다.
Base URL
OpenAI 호환 클라이언트를 다음 두 값으로 지정하세요:
| 변수 | 값 |
|---|---|
BASE_URL | https://api.unorouter.com/v1 |
API_KEY | 토큰 페이지에서 만드는 키 |
네이티브 와이어 프로토콜을 사용하는 도구는 대신 도메인만 사용합니다. Claude Code는 ANTHROPIC_BASE_URL을, Gemini CLI는 GOOGLE_GEMINI_BASE_URL을 /v1 접미사 없이 설정합니다. 각 통합 가이드에 정확한 값이 나와 있습니다.
API 키 만들기
가입한 다음 토큰 페이지를 열어 키를 만드세요. 이름을 지정하고, 만료 날짜, 지출 한도, 허용 모델 및 IP 허용 목록도 설정할 수 있습니다. 키는 한 번만 표시되므로 안전하게 보관하세요.
키가 없어도 게스트로 무료 모델에서 내장 채팅을 사용할 수 있습니다. API 요청에는 항상 키가 필요합니다.
첫 요청 보내기
YOUR_API_KEY를 방금 만든 키로 바꾸세요(로그인한 경우 아래에 이미 입력되어 있습니다):
curl https://api.unorouter.com/v1/chat/completions \
-H "Content-Type: application/json" \
-H "Authorization: Bearer YOUR_API_KEY" \
-d '{
"model": "gpt-oss-120b:free",
"messages": [{ "role": "user", "content": "Hello!" }]
}':free 접미사가 붙은 모델은 무료입니다. 잔액을 사용하려면 카탈로그에서 다른 아무 모델이나 선택하세요.
공식 SDK 사용하기
모든 OpenAI SDK가 변경 없이 작동합니다. base URL과 키만 설정하세요:
Python
from openai import OpenAI
client = OpenAI(
base_url="https://api.unorouter.com/v1",
api_key="YOUR_API_KEY",
)
completion = client.chat.completions.create(
model="gpt-oss-120b:free",
messages=[{"role": "user", "content": "Hello!"}],
)
print(completion.choices[0].message.content)Node.js
import OpenAI from "openai";
const client = new OpenAI({
baseURL: "https://api.unorouter.com/v1",
apiKey: "YOUR_API_KEY",
});
const completion = await client.chat.completions.create({
model: "gpt-oss-120b:free",
messages: [{ role: "user", content: "Hello!" }],
});
console.log(completion.choices[0].message.content);다음 단계
통합 탭에는 SillyTavern, JanitorAI, Claude Code, Cline 등 30개 이상의 앱을 위한 복사-붙여넣기 설정이 있습니다. 채팅 탭은 내장된 롤플레이 채팅을 설명합니다.
모든 모델과 실시간 가격은 모델 페이지에서, 커뮤니티가 검증한 무료 모델 신뢰성은 순위에서, 제공업체 상태는 상태 페이지에서 확인하세요.