홈 / 가이드 / 무료 OpenAI 호환 API Base URL

무료 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 키
Groqhttps://api.groq.com/openai/v1Groq API 키
OpenRouterhttps://openrouter.ai/api/v1OpenRouter 키. :free로 끝나는 모델 ID를 사용하세요.
NVIDIA API Cataloghttps://integrate.api.nvidia.com/v1NVIDIA API 키
Cloudflare Workers AIhttps://api.cloudflare.com/client/v4/accounts/<account-id>/ai/v1Cloudflare API 토큰
Coherehttps://api.cohere.ai/compatibility/v1Cohere 체험 키 또는 운영 키
Z.ai (Zhipu)https://api.z.ai/api/paas/v4/Z.ai API 키
OVHcloud AI Endpointshttps://oai.endpoints.kepler.ai.cloud.ovh.net/v1선택 사항. 낮은 한도로 익명 사용이 허용됩니다.
Kilo Gatewayhttps://ai-gateway.kilo.ai/api/v1무료 모델에는 선택 사항
AI Hordehttps://oai.aihorde.net/v1Horde 키, 또는 익명 키 0000000000
Mistralhttps://api.mistral.ai/v1Mistral 키. API에는 결제 활성화가 필요합니다.
Scaleway Generative APIshttps://api.scaleway.ai/v1Scaleway 시크릿 키
참고: 일부 SDK는 Base URL에 /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 토큰입니다. 표는 각 모델을 무료로 제공하는 제공업체를 보여 줍니다.

도구 호출과 128K 이상 컨텍스트를 지원하는 무료 모델
모델무료 제공컨텍스트무료 한도 (가장 좋은 조건)도구비전
GLM 5.3 FlashNVIDIA NIM1M40 요청/분
40 RPM
예아니요
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quota예예
Gemini 3.7 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예예
Qwen3.8 27BGroq, OVH AI Endpoints262K30 요청/분
250 요청/일
70,000 토큰/분
~6M
예예
Gemini 3.6 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/day예예
Gemini 3.5 FlashGoogle AI Studio1M10 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Nemotron 3 Ultra 550BKilo Gateway, NVIDIA NIM, OpenRouter1M20 요청/분
50 요청/일
50 req/day account-wide (1,000 after a $10 purchase)
예아니요
Gemini 3.5 Flash LiteGoogle AI Studio1M15 요청/분
20 요청/일
250,000 토큰/분
~3M
예예
Qwen3.6 27BOVH AI Endpoints131K2 요청/분
2/min per IP
예아니요
Muse Glimmer 30BNVIDIA NIM131K40 요청/분
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 FoundBase URL의 경로가 잘못되었거나, /chat/completions가 포함되어 있음표의 Base URL을 정확히 사용하세요
401 Unauthorized키가 다른 제공업체의 키임Base URL과 같은 제공업체의 키를 사용하세요
올바른 요청인데도 400제공업체가 매개변수 하나를 지원하지 않음logprobs나 n 같은 매개변수를 삭제하세요
모델을 찾을 수 없음모델 ID가 다른 제공업체의 ID임Base URL에서 GET /v1/models를 호출하세요
429 Too Many Requests무료 한도에 도달함초기화될 때까지 기다리거나, 장애 대응을 하는 게이트웨이를 쓰세요
하나의 키로 이 모델을 모두 사용하십시오. FreeLLMAPI는 오픈 소스이며 직접 호스팅하는 라우터입니다. 이 모든 무료 제공 서비스를 하나의 OpenAI 호환 엔드포인트로 묶고, 요청 한도에 걸리면 다른 모델로 자동 전환합니다. 카탈로그 보기 또는 바로 시작.

자주 묻는 질문

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로 향하게 하면, 라우터가 요청마다 제공업체를 고릅니다.

관련 가이드

출처

전체 가이드 · 무료 모델 전체 보기