Hermes Agent — 카페24 LLM Router 연결 가이드
💡 요약 정리
- 카페24 LLM Router의 API를 Hermes Agent의 메인 모델로 연결하는 방법입니다.
- 100종+ AI 모델을 하나의 API 키로 사용하고, 가입 시 ₩1,000 무료 크레딧으로 바로 시작할 수 있습니다.
- 순서: ① LLM Router 가입 → ② API 키 생성 → ③ Hermes에 Custom endpoint로 연결
- LLM Router는 OpenAI 호환 엔드포인트라, Hermes의 Custom endpoint + Auto-detect로 간단히 연결됩니다.
- 용도별 모델 추천은 3-6을 참고하세요.
이 문서는 초기 설정 가이드의 2-1. Model & Provider 단계에서 LLM Router를 선택하는 경우를 위한 상세 안내입니다. 전체 설치 흐름은 초기 설정 가이드를 먼저 참고하세요.
1. 카페24 LLM Router 가입
Hermes에 연결하려면 먼저 카페24 LLM Router 서비스에 가입해야 합니다.
- 카페24 LLM Router에 접속합니다.
- 카페24 호스팅 회원으로 로그인합니다. (호스팅 회원이 아니라면 먼저 회원가입)
- 약관 동의 후 아이디(신규 자아이디 또는 비어있는 기존 자아이디)를 선택하고 신청 완료합니다.
신청이 완료되면 즉시 ₩1,000 무료 크레딧이 지급되어 바로 사용할 수 있습니다. 가입 시점에 카드 등록은 필요 없습니다.
가입 절차·무료 크레딧·연령 제한 등 자세한 내용은 LLM Router 가입하기 가이드를 참고하세요.
2. API 키 생성
Hermes 연결에는 API 키와 Base URL이 필요합니다. LLM Router 콘솔에서 발급합니다.
- LLM Router 콘솔에서 API 키 관리 메뉴로 이동합니다.
- 키 이름 · 크레딧 한도 · 만료일을 설정하고 키를 생성합니다.
- 생성된 API 키 값을 복사해 안전한 곳에 보관합니다.
- 같은 페이지 상단에서 Base URL을 확인합니다. (Hermes에 입력할 값:
https://llm-router.cafe24.com/api/v1)
API 키 값은 발급 직후 1회만 표시됩니다. 화면을 벗어나면 다시 조회할 수 없으니, 생성 즉시 복사해 안전한 곳에 저장하세요. 분실 시 새 키를 발급해야 합니다.
콘솔 메뉴(모델 비교 · 체험하기 · 사용 현황 · 크레딧 충전 등) 사용법은 처음 시작하는 사용자를 위한 가이드에서 확인할 수 있습니다.
3. Hermes Agent에 LLM Router 연결
API 키를 준비했다면, Hermes 설정 마법사로 돌아가 연결합니다. (초기 설정 가이드 2-1. Model & Provider 단계)
3-1. Provider 선택 — Custom endpoint
프로바이더 선택 화면에서 Custom endpoint (enter URL manually) 를 선택합니다.
Select provider:
↑↓ navigate ENTER/SPACE select ESC cancel
(○) Anthropic (Claude models via API key or Claude Code)
(○) OpenAI ▸ (Codex CLI or direct OpenAI API)
...
(○) custom (direct API)
→ (●) Custom endpoint (enter URL manually)
3-2. Base URL 입력
Base URL 입력 프롬프트에 LLM Router 주소를 입력하고 Enter를 누릅니다.
Enter the base URL for your OpenAI-compatible endpoint:
https://llm-router.cafe24.com/api/v1
3-3. API 키 입력
발급한 LLM Router API 키를 붙여넣고 Enter를 누릅니다. (입력값은 ********로 마스킹)
Paste your API key: ********
✔ API key saved
3-4. API 호환 모드 선택 — Auto-detect
API 호환 모드를 묻는 화면이 표시됩니다. LLM Router는 OpenAI 호환 엔드포인트이므로 1. Auto-detect를 선택합니다.
Select API compatibility mode:
1. Auto-detect [current]
Use Hermes URL heuristics; best for standard OpenAI-compatible endpoints.
2. Chat Completions
Use /chat/completions for standard OpenAI-compatible servers.
3. Responses / Codex
Use /responses for Codex-compatible tool-calling backends.
4. Anthropic Messages
Use /v1/messages for Anthropic-compatible endpoints.
| 모드 | 용도 |
|---|---|
| Auto-detect (권장) | URL 기준으로 표준 OpenAI 호환 엔드포인트를 자동 인식 |
| Chat Completions | /chat/completions 고정 (표준 OpenAI 호환 서버) |
| Responses / Codex | /responses 사용 (Codex 호환 tool-calling 백엔드) |
| Anthropic Messages | /v1/messages 사용 (Anthropic 호환 엔드포인트) |
대부분의 경우 Auto-detect로 정상 동작합니다. 특정 응답 형식이 필요한 경우에만 2~4번을 직접 선택하세요.
3-5. 모델 선택
호환 모드에서 1 (Auto-detect)을 선택하면, LLM Router가 제공하는 사용 가능한 모델 목록이 번호와 함께 표시됩니다. 100종+ 모델이 나열되며, 사용할 모델의 번호를 입력합니다.
Choice [1-4, Enter to keep current/detected]: 1
API mode: auto-detect
Available models:
1. ByteDance-Seed/Seed-OSS-36B-Instruct
2. ByteDance/Seed-1.8
3. ByteDance/Seed-2.0-code
...
11. NousResearch/Hermes-3-Llama-3.1-405B
12. NousResearch/Hermes-3-Llama-3.1-70B
13. Qwen/Qwen2.5-72B-Instruct
...
26. Qwen/Qwen3-Max
...
54. anthropic/claude-haiku-4-5
55. anthropic/claude-opus-4-7
56. anthropic/claude-opus-4-8
57. anthropic/claude-sonnet-4-6
58. deepseek-ai/DeepSeek-R1
...
60. deepseek-ai/DeepSeek-V3
61. deepseek-ai/DeepSeek-V3
... (이하 생략 — LLM Router가 제공하는 100종+ 모델)
목록은 LLM Router에 등록된 모델 기준으로 표시되며 수시로 갱신됩니다. 위 목록은 출력 형태를 보여주기 위한 예시이고, 실제 번호·모델 구성은 접속 시점에 따라 다를 수 있습니다.
3-6. 용도별 모델 추천
어떤 모델을 고를지 고민된다면 아래 추천을 참고하세요. (실제 사용 가능 모델은 LLM Router 콘솔 "Models"에서 확인)
| 용도 | 추천 모델 |
|---|---|
| 일반 작업 (최고 효율 · 무료 크레딧 기반 작업 가능) | DeepSeek-V4-Flash (기본 선택) · gpt-oss-120b · NVIDIA-Nemotron-3-Super-120B-A12B |
| 멀티모달 · 이미지/문서 이해 (효율) | gemini-3.5-flash |
| 코딩 · 고급 작업 | claude-sonnet-4-6 · claude-opus-4-8 · DeepSeek-V4-Pro · Kimi-K2.6 · GLM-5.2 |
처음에는 DeepSeek-V4-Flash 같은 고효율 모델로 시작해 무료 크레딧으로 충분히 테스트한 뒤, 코딩·고급 작업이 필요할 때 claude-sonnet-4-6·claude-opus-4-8 등으로 바꾸는 것을 권장합니다. 모델 비교·체험은 LLM Router 콘솔의 "Models"·"체험하기"에서 무료 크레딧 범위로 가능합니다.
연결이 끝나면 이후 단계(Terminal Backend · Messaging · Tools)는 초기 설정 가이드의 흐름을 그대로 따라 진행하면 됩니다.
모델 변경 · Credential Pool · Fallback 등 운영 단계는 운영 가이드를, LLM Router 크레딧 충전 · 사용 현황은 LLM Router 가이드를 참고하세요.