주요 이미지 모델을 이제 지원합니다 · GPT-Image, Nano Banana, Seedream 등
블로그
가이드

Hermes Agent에 OmniaKey 연결하기: OpenAI 호환 API 설정

Hermes Agent를 OmniaKey 커스텀 OpenAI 호환 endpoint에 연결하는 방법을 안내합니다. hermes model, config.yaml, 모델 전환과 404 오류를 확인하세요.

약 4분OmniaKey
Hermes AgentAPI 설정OpenAI 호환config.yamlOmniaKey

Hermes Agent API 설정을 찾고 있다면 커스텀 OpenAI 호환 endpoint 하나를 등록하면 됩니다. Nous Research의 Hermes Agent는 Provider를 다시 설정하지 않고 model ID로 Claude, GPT, Gemini, Grok을 선택할 수 있습니다.

가장 빠른 방법: hermes model

bash
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에 같은 값을 작성합니다.

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하지 않습니다.

OpenAI-compatible
https://api.omniakey.com/v1
Anthropic-native
https://api.omniakey.com
Gemini-native
https://api.omniakey.com/v1beta

다른 도구 설정은 코딩 Agent 안내를 참고하세요.