Hermes Agent는 OpenAI 호환 chat/completions 프로토콜을 사용합니다. 커스텀 엔드포인트를 4AICode로 지정하면 Hermes에서 gpt-6-astra, gpt-5.6-sol, gpt-5.5, gpt-5.4, gpt-5.4-mini 등 모델을 사용할 수 있습니다.
사전 준비
- 4AICode 토큰: 대시보드 → 토큰 관리에서 생성. 형식은
sk-4ai-... - Base URL:
https://relay.4aicode.com/v1 - 권장 모델: 일상 사용은
gpt-5.4가 더 안정적, 가벼운 작업·비용 민감 시나리오는gpt-5.4-mini
설정
Hermes 내장 모델 설정 마법사 실행:
hermes model
프롬프트에 따라 선택:
More providers...
Custom endpoint (enter URL manually)
다음 입력:
API base URL: https://relay.4aicode.com/v1
API key: sk-4ai-xxxxxxxxxxxxxxxx
모델 목록에서 선택:
gpt-5.4
설정 완료 후:
hermes chat
사용 가능한 모델
| Model | 적합 용도 |
|---|---|
gpt-6-astra | 차세대 플래그십; 공식 가격의 15% 과금 |
gpt-5.6-sol | 복잡한 코딩, 장시간 작업, 다중 파일 리팩터링용 플래그십 |
gpt-5.6-terra / gpt-5.6-luna | 균형 / 더 저렴하고 빠름 |
gpt-5.5 | 이전 세대 플래그십 |
gpt-5.4 | 권장 기본; 일반 작업에 더 안정적 |
gpt-5.4-mini | 일반 Q&A, 간단한 문구 수정, 짧은 코드; 빠르고 저비용 |
gpt-5.3-codex | 코드 최적화 모델 |
테스트
Hermes에 들어가 다음 메시지 전송:
Hello, introduce yourself in one sentence
정상 응답이면 설정이 완료된 것입니다.
FAQ
모델 응답이 비어 있음
Hermes는 /v1/chat/completions를 사용합니다. hermes model에서 Base URL을 https://relay.4aicode.com/v1로 입력하면 Hermes가 자동으로 /chat/completions를 붙입니다.
hermes model을 다시 실행해 Base URL, API key, Model 이름을 확인하세요.
response.created / response.completed가 보임
클라이언트가 Responses API의 SSE 이벤트 스트림을 받은 것입니다. Hermes는 Chat Completions 형식이 필요하며, 4AICode의 /v1/chat/completions가 자동 변환합니다. 발생 시 확인:
base_url이https://relay.4aicode.com/v1인지- 요청 경로가
/v1/chat/completions인지 - 4AICode 백엔드가 최신 버전으로 배포됐는지
Model not supported
gpt-5, gpt-5-codex 등 구 모델명은 deprecated되었습니다. hermes model을 다시 실행해 gpt-5.4를 선택하세요.