n8n용 무료 LLM API
n8n은 AI 노드를 갖춘 워크플로 자동화 도구입니다. OpenAI 자격 증명에는 Base URL 필드가 있으므로, 요청을 OpenAI 호환 API로 보낼 수 있습니다. 이 가이드는 그 필드가 FreeLLMAPI를 가리키도록 설정하는 방법을 설명합니다. FreeLLMAPI는 45개의 무료 제공업체 요금제를 하나의 키 뒤에 묶고, 한도 때문에 요청이 실패하면 다음 제공업체로 넘어갑니다.
코드, 모델 이름, 실시간 카탈로그 레이블은 영어로 표시합니다.
준비 사항
- n8n, 자체 호스팅 또는 n8n Cloud. 클라우드 인스턴스는 사용자 컴퓨터의
localhost에 접근할 수 없습니다. n8n Cloud를 쓴다면 FreeLLMAPI에 공개 HTTPS 주소가 있어야 합니다. - FreeLLMAPI, Docker 또는 데스크톱 앱으로 설치. Keys 페이지에 무료 제공업체 키를 두 개 이상 추가하세요.
- FreeLLMAPI Keys 페이지의 통합 키. n8n은 이 키만 사용합니다.
FreeLLMAPI 설치 (macOS 또는 Linux)
curl -fsSL https://freellmapi.co/install.sh | bashBase URL은 n8n이 실행되는 위치에 따라 다릅니다. Docker 컨테이너 안에서 localhost는 사용자 컴퓨터가 아니라 컨테이너를 가리킵니다.
| n8n 실행 위치 | Base URL |
|---|---|
| 호스트에서 (npm 또는 npx) | http://localhost:3001/v1 |
| Docker Desktop에서 (macOS, Windows) | http://host.docker.internal:3001/v1 |
| FreeLLMAPI와 같은 호스트의 Linux Docker에서 | n8n 컨테이너를 FreeLLMAPI Docker 네트워크에 연결한 후 http://freellmapi:3001/v1 |
| n8n Cloud | FreeLLMAPI 서버의 공개 HTTPS 주소. 끝에 /v1을 붙입니다. |
1단계: OpenAI 자격 증명 만들기
- n8n에서 Credentials를 열고 OpenAI 유형의 새 자격 증명을 만드세요.
- API Key에 FreeLLMAPI 통합 키를 붙여 넣으세요.
- Organization ID (optional)은 비워 두세요.
- Base URL에서
https://api.openai.com/v1을 FreeLLMAPI URL로 바꾸세요. 예:http://host.docker.internal:3001/v1. - 자격 증명을 저장하세요.
이 자격 증명을 사용하는 모든 OpenAI 노드는 이제 요청을 FreeLLMAPI로 보냅니다. 실제 제공업체 키는 FreeLLMAPI에 남아 있습니다. n8n에는 들어가지 않습니다.
n8n 컨테이너에서 URL 테스트하기
docker exec n8n wget -qO- \
--header="Authorization: Bearer <unified-key>" \
http://host.docker.internal:3001/v1/models | head -c 3002단계: AI Agent 워크플로 만들기
AI Agent 노드에는 채팅 모델 하위 노드와 하나 이상의 도구 하위 노드가 필요합니다. n8n 1.82.0부터 모든 AI Agent 노드는 Tools Agent로 동작합니다. 에이전트는 도구 정의를 모델에 보내므로, 모델이 도구 호출을 지원해야 합니다.
- Chat Trigger 노드를 추가하세요. 워크플로를 테스트할 채팅 창이 생깁니다.
- 트리거 뒤에 AI Agent 노드를 추가하세요.
- OpenAI Chat Model 하위 노드를 에이전트의 Chat Model 입력에 연결하세요. FreeLLMAPI 자격 증명을 선택하세요.
- Model에서 모드를 From List에서 ID로 바꾸세요.
auto를 입력하세요. - 도구 하위 노드를 연결하세요. 예: Calculator 도구 또는 HTTP Request 도구.
- 채팅을 열고 테스트 메시지를 보내세요.
모델에는 ID 모드를 사용하세요. 목록 모드는 전체 FreeLLMAPI 카탈로그를 보여 주며, 여기에는 아직 호출할 수 없는 모델도 포함됩니다. n8n에서 유용한 ID는 다음과 같습니다.
| 모델 ID | 용도 |
|---|---|
auto | 일반 워크플로. 라우터가 폴백 체인을 따릅니다. |
auto:fast | 분류, 짧은 요약 및 기타 처리량이 많은 단계 |
auto:smart | 계획을 세우거나 도구를 선택해야 하는 에이전트 단계 |
auto:reliable | 실패하면 안 되는 예약 워크플로 |
auto:<profile> | 이름이 붙은 폴백 체인. 예: 도구 호출 모델만 포함된 체인 |
에이전트 단계에서는 체인에 도구 호출 모델만 남기세요. 현재 다음 무료 모델이 도구 호출을 지원합니다.
| 모델 | 무료 제공 | 컨텍스트 | 무료 한도 (가장 좋은 조건) | 도구 | 비전 |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 요청/분 1 req/min per model | 예 | 아니요 |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 요청/분 40 RPM | 예 | 예 |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | 예 | 예 |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | 예 | 아니요 |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 요청/분 20 요청/일 250,000 토큰/분 ~3M | 예 | 예 |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | 예 | 예 |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 요청/분 50 요청/일 50 req/day account-wide (1,000 after a $10 purchase) | 예 | 예 |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 요청/분 50 요청/일 Shared rate limit | 예 | 아니요 |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 요청/분 250 요청/일 70,000 토큰/분 ~6M | 예 | 예 |
일치하는 무료 모델 109개 중 10개를 표시합니다. 모든 모델 보기.
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
3단계: 무료 요금제 한도 처리하기
500개 항목을 반복하는 워크플로는 요청 500개를 보냅니다. 무료 요금제에는 분당 및 일일 요청 한도가 있습니다. FreeLLMAPI는 각 키의 할당량을 세고, 429 오류가 발생하면 다음 제공업체로 넘어갑니다. 체인의 모든 키가 한도에 도달하면, 게이트웨이는 Retry-After 헤더와 함께 429를 반환합니다.
짧은 한도 때문에 워크플로가 멈추지 않도록 다음 옵션을 설정하세요.
| 위치 | 설정 | 값 |
|---|---|---|
| OpenAI Chat Model, Options | Max Retries | 3~5 |
| OpenAI Chat Model, Options | Timeout | 긴 프롬프트에는 60000ms 이상 |
| 노드 설정 (톱니바퀴 아이콘) | Retry On Fail | On |
| 노드 설정 | Max. Tries | 3 |
| 노드 설정 | Wait Between Tries (ms) | 5000 이상 |
| Loop Over Items 노드 | Batch Size | 작은 배치, 배치 사이에 Wait 노드 추가 |
더 많은 제공업체의 키를 추가하면 하루 총 요청 수를 늘릴 수 있습니다. 표에는 오늘 카탈로그의 제공업체별 무료 한도가 나와 있습니다.
| 제공업체 | 무료 모델 | 최대 요청/분 | 최대 요청/일 | 최대 토큰/분 | 월간 토큰 (모델 1개) | 가장 성능이 좋은 무료 모델 |
|---|---|---|---|---|---|---|
| ElectronHub | 84 | - | - | - | $0.25/week shared recurring credit | Qwen3.8 Flash (ElectronHub)qwen3.8-flash |
| Cloudflare Workers AI | 39 | - | - | - | ~5-10M | Qwen 3.8 27B (Cloudflare Workers AI)@cf/qwen/qwen3.8-27b |
| Inferbase | 38 | - | - | - | 5,000 requests/month; 100 requests and $0.50 usage/day shared | DeepSeek V4 Flash (fp8) (Inferbase)deepseek-v4-flash:fp8 |
| AI Horde | 31 | - | - | - | Ongoing volunteer queue; availability varies | Gemma 4 31B Heretic (AI Horde)koboldcpp/gemma-4-31B-it-heretic |
| ACLIDE | 29 | - | - | - | €20/month shared internal usage credits · no card | Qwen3.8 Max (ACLIDE)qwen/qwen3.8-max:free |
| Google AI Studio | 21 | 15 | 1,000 | 250,000 | ~3M | Gemini 3.8 Flashgemini-3.8-flash |
| Api.Airforce | 20 | 1 | 1,000 | - | free · 1,000 req/day · 1 req/min | gpt-oss-20b (Api.Airforce)gpt-oss-20b |
| NVIDIA NIM | 19 | 40 | - | - | free · 40 RPM | GLM 5.3 Flash (NV)z-ai/glm-5.3-flash |
| Cohere | 17 | 20 | 33 | - | ~1-2M | Command A+ (05-2026)command-a-plus-05-2026 |
| DreamPrompting | 14 | 100 | 5,000 | - | free · 500K tokens/day · 5,000 req/day | Gemini 3.1 Flash-Litegoogle/gemini-3.1-flash-lite |
FreeLLMAPI 카탈로그의 실시간 데이터입니다 (버전 2026.11.19, 2026-11-19 확인). 무료 한도는 자주 바뀝니다. 카탈로그는 매일 확인합니다.
HTTP Request 노드 사용하기
일반 HTTP Request 노드로도 FreeLLMAPI를 호출할 수 있습니다. OpenAI 노드가 보여 주지 않는 매개변수가 필요하거나, 응답 헤더를 확인하고 싶을 때 이 방법을 사용하세요.
- 메서드:
POST - URL:
http://host.docker.internal:3001/v1/chat/completions - 헤더:
Authorization, 값은Bearer <unified-key> - Body 콘텐츠 유형: JSON
JSON 본문
{
"model": "auto:fast",
"messages": [
{"role": "system", "content": "Classify the ticket as billing, bug or other. Reply with one word."},
{"role": "user", "content": "{{ $json.ticket_text }}"}
],
"temperature": 0
}답변은 choices[0].message.content에 있습니다. 응답 헤더 X-Routed-Via는 답변한 제공업체와 모델을 보여 줍니다. 라우터가 제공업체를 바꾸었다면, X-Fallback-Attempts는 실패한 시도 횟수를 보여 줍니다.
문제 해결
| 문제 | 원인 | 해결 방법 |
|---|---|---|
| 자격 증명 테스트가 연결 오류로 실패함 | localhost가 n8n 컨테이너를 가리킴 | host.docker.internal을 쓰거나 공유 Docker 네트워크를 사용하세요 |
| 오류 401 | 잘못된 키 | 통합 키를 다시 붙여 넣으세요 |
| 모델 목록에 수백 개 항목이 있음 | 목록 모드는 전체 카탈로그를 읽습니다 | ID 모드를 쓰고 auto를 입력하세요 |
| 에이전트가 답변하지만 도구를 사용하지 않음 | 선택한 모델이 도구 호출을 지원하지 않음 | 위 표의 모델을 쓰거나, 도구 호출 모델이 포함된 프로필을 사용하세요 |
| 긴 반복에서 오류 429 발생 | 모든 키가 한도에 도달함 | 제공업체를 추가하고, 더 작은 배치를 쓰고, Retry On Fail을 켜세요 |
| 노드 시간 초과 | 긴 프롬프트를 처리하는 느린 무료 모델 | Timeout을 늘리거나 auto:fast를 사용하세요 |
자주 묻는 질문
n8n OpenAI 노드에서 사용자 지정 Base URL을 쓸 수 있나요?
예. n8n의 OpenAI 자격 증명에는 Base URL 필드가 있습니다. /v1로 끝나는 OpenAI 호환 URL로 설정하세요. 예를 들어 FreeLLMAPI라면 http://localhost:3001/v1입니다.
n8n에서 쓸 수 있는 무료 LLM API가 있나요?
예. 무료 제공업체 요금제는 OpenAI 자격 증명을 통해 n8n에서 동작합니다. FreeLLMAPI는 여러 무료 요금제를 하나의 키 뒤에 묶습니다. 각 요금제에는 고유한 요청 한도가 있습니다.
n8n AI Agent 노드에서 작동하는 무료 모델은 무엇인가요?
도구 호출을 지원하는 모델을 쓰세요. AI Agent 노드는 Tools Agent로 동작하기 때문입니다. 이 페이지의 표에 도구 호출을 지원하는 무료 모델이 나와 있습니다.
n8n 워크플로가 요청 한도 때문에 실패하지 않게 하려면 어떻게 하나요?
채팅 모델 노드에서 Max Retries를 설정하고, 노드 설정에서 Retry On Fail을 켜고, 항목을 작은 배치로 처리하세요. 더 많은 제공업체의 키를 추가하면 하루 총량을 늘릴 수 있습니다.
n8n Cloud에서 자체 호스팅 LLM 게이트웨이를 쓸 수 있나요?
게이트웨이에 공개 HTTPS 주소가 있을 때만 가능합니다. n8n Cloud는 사용자 컴퓨터의 localhost에 접근할 수 없습니다.
관련 가이드
- AI 에이전트용 무료 LLM API
- 함수 호출을 지원하는 무료 LLM API
- 무료 OpenAI 호환 API Base URL
- 무료 LLM API 속도 제한
- LangChain용 무료 LLM API
출처
- n8n source: OpenAI credential fields (API Key, Organization ID, Base URL) (20 November 2026 확인)
- n8n docs: OpenAI Chat Model node (20 November 2026 확인)
- n8n docs: AI Agent node (20 November 2026 확인)
- n8n docs: node settings (Retry On Fail) (20 November 2026 확인)
- FreeLLMAPI docs: REST API (routing strategies, response headers) (20 November 2026 확인)