빠른 시작
5분 만에 동작하는 API 호출.
UnoRouter은 OpenAI, Anthropic, Google, DeepSeek, Qwen 등 50개 이상 제공자의 200개 이상 모델을 하나의 OpenAI 호환 엔드포인트로 제공합니다. 문자열 하나만 바꾸면 모델이 바뀝니다. 상당수는 무료이며 카드도 필요 없습니다.
내장 채팅은 가입 없이 무료 모델을 실행합니다. 대화는 브라우저에 남습니다.
OpenAI 호환 클라이언트를 다음 두 값으로 지정하세요:
| 변수 | 값 |
|---|---|
BASE_URL | https://api.unorouter.com/v1 |
API_KEY | 토큰 페이지에서 만드는 키 |
네이티브 프로토콜을 쓰는 도구에는 /v1 없이 도메인만 넣습니다: Claude Code는 ANTHROPIC_BASE_URL, Gemini CLI는 GOOGLE_GEMINI_BASE_URL을 씁니다. 정확한 값은 각 연동 안내에 있습니다.
가입하고 Tokens 페이지를 열어 키를 만드세요. 키는 한 번만 표시됩니다.
만료일, 지출 한도, 모델 허용 목록, 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로 끝나는 모델은 무료입니다. 그 외 모델은 잔액을 씁니다.
어떤 OpenAI SDK든 그대로 동작합니다. 기본 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개 이상 앱의 설정이 있습니다. 채팅 페이지는 내장 롤플레이 클라이언트를 설명합니다.
가격, 할인, 가용성이 어떻게 동작하는지는 다음을 읽어보세요: 모델 및 가격
배포 전에 상태 코드와 속도 제한을 훑어보세요: 속도 제한 및 오류