무료 OpenAI 호환 API Base URL
대부분의 무료 LLM 제공업체는 OpenAI API 형식을 받습니다. 클라이언트에서 값 두 개만 바꾸면 됩니다. Base URL과 API 키입니다. 이 페이지는 각 무료 제공업체의 Base URL을 나열하며, 값은 제공업체의 공식 문서로 확인했습니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
무료 제공업체의 Base URL
| 제공업체 | OpenAI 호환 Base URL | 키 |
|---|---|---|
| Google AI Studio (Gemini) | https://generativelanguage.googleapis.com/v1beta/openai/ | Gemini API 키 |
| Groq | https://api.groq.com/openai/v1 | Groq API 키 |
| OpenRouter | https://openrouter.ai/api/v1 | OpenRouter 키. :free로 끝나는 모델 ID를 사용하세요. |
| NVIDIA API Catalog | https://integrate.api.nvidia.com/v1 | NVIDIA API 키 |
| Cloudflare Workers AI | https://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1 | Cloudflare API 토큰 |
| Cohere | https://api.cohere.ai/compatibility/v1 | Cohere 체험 키 또는 운영 키 |
| Z.ai (Zhipu) | https://api.z.ai/api/paas/v4/ | Z.ai API 키 |
| OVHcloud AI Endpoints | https://oai.endpoints.kepler.ai.cloud.ovh.net/v1 | 선택 사항. 낮은 한도로 익명 사용이 허용됩니다. |
| Kilo Gateway | https://ai-gateway.kilo.ai/api/v1 | 무료 모델에는 선택 사항 |
| AI Horde | https://oai.aihorde.net/v1 | Horde 키, 또는 익명 키 0000000000 |
| Mistral | https://api.mistral.ai/v1 | Mistral 키. API에는 결제 활성화가 필요합니다. |
| Scaleway Generative APIs | https://api.scaleway.ai/v1 | Scaleway 시크릿 키 |
/chat/completions를 덧붙입니다. Base URL에 /chat/completions를 직접 넣지 마세요. 끝의 경로는 표시된 그대로 유지하세요.클라이언트에서 Base URL 바꾸는 방법
OpenAI SDK는 매개변수 또는 환경 변수에서 Base URL을 읽습니다. 이 예제는 Groq를 사용합니다. 다른 제공업체를 쓰려면 URL, 키, 모델 ID를 바꾸세요.
Python (OpenAI SDK)
from openai import OpenAI
client = OpenAI(
base_url="https://api.groq.com/openai/v1",
api_key="<groq-key>",
)
resp = client.chat.completions.create(
model="openai/gpt-oss-20b",
messages=[{"role": "user", "content": "Say hello"}],
)
print(resp.choices[0].message.content)환경 변수
export OPENAI_BASE_URL=https://api.groq.com/openai/v1
export OPENAI_API_KEY=<groq-key>Open WebUI, Cline, Aider 같은 많은 도구에는 OpenAI 호환 Base URL 필드가 있습니다. 표의 URL을 그 필드에 넣으세요.
사용하기 전에 Base URL 테스트하기
도구를 설정하기 전에 두 가지를 확인하세요. 첫째, 모델을 나열하세요. 이 확인으로 URL과 키가 올바른지 알 수 있습니다. 둘째, 짧은 채팅 요청을 한 번 보내세요. 이 확인으로 모델 ID가 유효하고 할당량이 있는지 알 수 있습니다.
URL, 키, 모델 하나 확인하기
BASE=https://api.groq.com/openai/v1
KEY=<groq-key>
# 1. List the models
curl -s $BASE/models -H "Authorization: Bearer $KEY" | head -c 600
# 2. Send one short request
curl -s $BASE/chat/completions \
-H "Authorization: Bearer $KEY" \
-H "Content-Type: application/json" \
-d '{"model": "openai/gpt-oss-20b", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 200}'추론 모델에는 아주 작은 max_tokens 값을 설정하지 마세요. 일부 무료 모델은 보이는 답변 전에 숨겨진 추론 토큰을 사용합니다. 상한이 작으면 응답이 빈 답변으로 끝날 수 있습니다.
첫 번째 확인이 401을 반환하면, 이 URL에 맞지 않는 키입니다. 두 번째 확인이 429를 반환하면, URL과 키는 맞지만 무료 한도에 도달한 것입니다. 제공업체의 요율 제한 헤더를 읽어 초기화 시간을 확인하세요.
알아 두어야 할 호환성 차이
"OpenAI 호환"이 모든 매개변수가 동작한다는 뜻은 아닙니다. 각 제공업체는 서로 다른 일부 기능만 지원합니다.
- Groq:
logprobs,logit_bias,top_logprobs,messages[].name, 또는 1이 아닌n을 포함한 요청은 오류 400을 반환합니다.temperature가 0이면1e-8로 바뀝니다. - Cloudflare: URL에는 계정 ID가 포함됩니다. 토큰은 Bearer 토큰으로 전송됩니다.
- AI Horde: 엔드포인트는
/v1/chat/completions와/v1/models를 지원합니다. 자원봉사자가 모델을 실행하므로 속도와 모델 목록이 바뀝니다. - 모델 ID: 각 제공업체는 자체 모델 이름을 씁니다. 유효한 ID를 얻으려면 각 Base URL에서
GET /v1/models를 읽으세요.
오늘 호출할 수 있는 무료 모델
다음 무료 모델은 도구 호출을 지원하고, 컨텍스트 창이 최소 128K 토큰입니다. 표는 각 모델을 무료로 제공하는 제공업체를 보여 줍니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 Flash | NVIDIA NIM | 1M | 40 요청/분 40 RPM | 예 | 아니요 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| Qwen3.8 27B | Groq, OVH AI Endpoints | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | 예 | 예 |
| Gemini 3.5 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Nemotron 3 Ultra 550B | Kilo Gateway, NVIDIA NIM, OpenRouter | 1M | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 아니요 |
| Gemini 3.5 Flash Lite | Google AI Studio | 1M | 15 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| Qwen3.6 27B | OVH AI Endpoints | 131K | 2 요청/분 2/min per IP | 예 | 아니요 |
| Muse Glimmer 30B | NVIDIA NIM | 131K | 40 요청/분 40 RPM | 예 | 예 |
일치하는 무료 모델 46개 중 12개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
모든 무료 제공업체를 위한 Base URL 하나
표의 각 Base URL에는 고유한 키와 고유한 요율 제한이 있습니다. 한 제공업체가 429 오류를 보내면, 코드를 다른 URL로 바꿔야 합니다. FreeLLMAPI는 대신 OpenAI 호환 Base URL 하나를 제공합니다. 이 게이트웨이는 사용자 컴퓨터에서 실행되며, 각 요청을 아직 할당량이 남은 무료 제공업체로 보냅니다.
설치하고 로컬 Base URL 호출하기
curl -fsSL https://freellmapi.co/install.sh | bash
export OPENAI_BASE_URL=http://localhost:3001/v1
export OPENAI_API_KEY=<unified-key>
curl $OPENAI_BASE_URL/chat/completions \
-H "Authorization: Bearer $OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "auto", "messages": [{"role": "user", "content": "hi"}]}'http://localhost:3001의 Keys 페이지에서 제공업체 키를 추가하세요.- 라우터가 선택하게 하려면
auto를 쓰세요. 속도나 지능을 우선하려면auto:fast또는auto:smart를 쓰세요. 모델 ID를 직접 보낼 수도 있습니다. X-Routed-Via응답 헤더는 답변한 제공업체와 모델을 보여 줍니다.- 같은 서버에는 Anthropic 클라이언트용
/v1/messages와 Gemini CLI용/v1beta도 있습니다.
FreeLLMAPI는 무료 요금제를 사용하므로, 각 제공업체의 요율 제한은 여전히 적용됩니다. 장애 대응은 부하를 제공업체 사이에 나누지만, 한도를 없애지는 않습니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| 404 Not Found | Base URL의 경로가 잘못되었거나, /chat/completions가 포함되어 있음 | 표의 Base URL을 정확히 사용하세요 |
| 401 Unauthorized | 키가 다른 제공업체의 키임 | Base URL과 같은 제공업체의 키를 사용하세요 |
| 올바른 요청인데도 400 | 제공업체가 매개변수 하나를 지원하지 않음 | logprobs나 n 같은 매개변수를 삭제하세요 |
| 모델을 찾을 수 없음 | 모델 ID가 다른 제공업체의 ID임 | Base URL에서 GET /v1/models를 호출하세요 |
| 429 Too Many Requests | 무료 한도에 도달함 | 초기화될 때까지 기다리거나, 장애 대응을 하는 게이트웨이를 쓰세요 |
자주 묻는 질문
Gemini의 OpenAI 호환 Base URL은 무엇인가요?
Google은 Base URL로 https://generativelanguage.googleapis.com/v1beta/openai/를 문서화합니다. API 키로는 AI Studio에서 받은 Gemini API 키를 사용하세요.
Groq의 OpenAI Base URL은 무엇인가요?
Groq는 https://api.groq.com/openai/v1를 문서화합니다. Groq API 키와 Groq 모델 ID를 사용하세요.
키 없이 쓸 수 있는 무료 OpenAI 호환 API가 있나요?
예. 다만 한도는 낮습니다. OVHcloud AI Endpoints는 IP와 모델마다 분당 익명 요청 2개를 허용합니다. Kilo Gateway는 무료 모델에 시간당 익명 요청 200개를 허용합니다.
무료 제공업체에서 OpenAI Python SDK를 쓸 수 있나요?
예. base_url을 제공업체 URL로, api_key를 제공업체 키로 설정하세요. 그 제공업체의 모델 ID를 사용하세요.
Base URL 하나로 여러 무료 제공업체를 쓰려면 어떻게 하나요?
사용자 컴퓨터에서 FreeLLMAPI 같은 게이트웨이를 실행하세요. 클라이언트를 통합 키 하나와 함께 http://localhost:3001/v1로 향하게 하면, 라우터가 요청마다 제공업체를 고릅니다.
관련 가이드
- 카드 없이 쓸 수 있는 무료 LLM API
- 가입 없이 쓰는 LLM API
- 무료 LLM API 속도 제한
- Python에서 무료 LLM API
- free llm api
- openrouter free alternative
출처
- Google AI Studio: OpenAI compatibility (20 November 2026 확인)
- GroqCloud: OpenAI compatibility (20 November 2026 확인)
- OpenRouter: API rate limits (20 November 2026 확인)
- NVIDIA API Catalog: API reference (20 November 2026 확인)
- Cloudflare Workers AI: OpenAI compatible endpoints (20 November 2026 확인)
- Cohere: Compatibility API (20 November 2026 확인)
- Z.ai: OpenAI Python SDK (20 November 2026 확인)
- OVHcloud: AI Endpoints Responses API (20 November 2026 확인)
- Kilo Gateway: Authentication (20 November 2026 확인)
- AI Horde README (20 November 2026 확인)
- Mistral API reference (20 November 2026 확인)
- Scaleway Generative APIs: Rate limits (20 November 2026 확인)
- FreeLLMAPI docs: REST API (20 November 2026 확인)