Hermes Agent에 OmniaKey 연결하기: OpenAI 호환 API 설정
Hermes Agent를 OmniaKey 커스텀 OpenAI 호환 endpoint에 연결하는 방법을 안내합니다. hermes model, config.yaml, 모델 전환과 404 오류를 확인하세요.
Hermes Agent API 설정을 찾고 있다면 커스텀 OpenAI 호환 endpoint 하나를 등록하면 됩니다. Nous Research의 Hermes Agent는 Provider를 다시 설정하지 않고 model ID로 Claude, GPT, Gemini, Grok을 선택할 수 있습니다.
가장 빠른 방법: hermes model
hermes model
**Custom endpoint (self-hosted / VLLM / etc.)**를 선택하고 다음을 입력합니다.
- Base URL:
https://api.omniakey.com/v1 - API key: OmniaKey key
- Model: 예:
claude-opus-4-8
Base URL은 /v1에서 끝내세요. Hermes가 /chat/completions를 자동으로 추가하므로 전체 경로나 끝의 슬래시는 404의 원인이 됩니다.
config.yaml 직접 설정
영구적인 다중 모델 설정이 필요하면 ~/.hermes/config.yaml에 같은 값을 작성합니다.
model:
provider: custom
base_url: https://api.omniakey.com/v1
api_key: your-omniakey-api-key
default: claude-opus-4-8
models:
- claude-opus-4-8
- gpt-5.5
- gemini-3.1-pro-preview
- grok-4.5
provider: custom은 내장 Provider가 아니라 위 endpoint를 직접 호출한다는 뜻입니다. models:가 /model 선택기를 채우므로 수정 후 Hermes를 한 번 재시작하세요.
하나의 key, 네 모델 계열
OmniaKey는 OpenAI 호환 인터페이스에서 model ID로 라우팅합니다. 두 번째 Provider나 여러 Base URL이 필요하지 않습니다. 비용은 하나의 선불 잔액에서 token 단위로 계산되며 지정한 ID가 실행됩니다. 더 싼 모델로 조용히 fallback하지 않습니다.
다른 도구 설정은 코딩 Agent 안내를 참고하세요.