> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiyi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hermes의 모델 목록에는 왜 일부 모델만 표시됩니까?

> Hermes 모델 선택기에 공급자별 모델 수가 50개로 제한되는 이유와 ID로 표시 목록에 없는 모델로 전환하는 방법을 알아봅니다.

## 간단한 답변

이 사례에서 검토한 Hermes 구현에서는 모델 선택기에 공급자당 최대 **50개 모델**이 표시됩니다. 이는 모델 선택기에 전송되는 데이터에 대한 제한이지, API 키의 모델 권한에 대한 제한이 아닙니다. API 엔드포인트나 Hermes 캐시에는 더 많은 모델 ID가 포함될 수 있습니다. 표시되는 목록에 없는 모델도 전체 ID를 사용해 선택할 수 있지만, 각 모델은 별도로 테스트해야 합니다.

모델 선택기는 `models` 필드를 `model_ids[:max_models]`로 자르지만, `total_models`에는 자르기 전의 개수가 유지됩니다. 따라서 `50 available`은 메뉴에 최대 50개 항목이 표시된다는 의미이지, 공급자에게 모델이 50개만 있다는 의미는 아닙니다.

동일한 백엔드, 프로필, 공급자 및 모델 카탈로그를 공유하는 경우 Hermes Desktop과 터미널 선택기는 동일한 선택 로직을 사용해야 합니다. 개수가 다르다면 모델 선택기에 전체 카탈로그보다 적은 모델이 표시되는 이유는 50개 제한일 수 있지만, 먼저 두 화면에서 동일한 공급자와 카탈로그를 사용하고 있는지 확인해야 합니다.

## 세 가지 목록 이해하기

| 진입점 | 의미 |
| - | - |
| `/v1/models` 또는 `provider_models_cache.json` | API가 반환하거나 Hermes의 캐시에 저장된 모델 ID |
| Hermes Desktop / `/model` 선택기 | 제공업체당 최대 50개의 모델 ID |
| `/model <model-id>` | 처음 50개에 표시되지 않아도 현재 채팅을 전체 모델 ID로 전환합니다 |

## 문제 해결 단계

1. **제공업체 행 확인**: `openai-api`, `openai`, `openrouter`는 각각 별도의 제공업체 항목이며, 제한은 각 제공업체에 개별적으로 적용됩니다. 한 제공업체의 선택 가능한 개수와 다른 제공업체의 전체 카탈로그 개수를 비교하는 대신, 데스크톱과 CLI에 같은 행이 표시되는지 확인합니다.
2. **모델 ID가 없으면 직접 입력**: 채팅에서 `/model gpt-5.5`를 사용하거나 `hermes chat --model gpt-5.5`로 세션을 시작합니다. `gpt-5.5`를 API 엔드포인트에서 반환된 정확한 모델 ID로 바꿉니다. 현재 설정에서 Hermes에 필요하다면 제공업체 접두사를 추가합니다.
3. **기본 모델 설정 및 확인**: `hermes config set model.default gemini-3.8-flash`을 사용한 다음 `hermes config show`을 실행하여 값이 올바른 필드에 기록되었는지 확인합니다. `hermes config set`은 모델 이름을 사용할 수 있는지 검증하지 않으므로 실제 요청으로 확인합니다.
4. **목록 제한과 호출 실패 구분**: 항목이 50개 표시된다는 것은 선택기 메뉴가 잘렸다는 의미일 뿐이며, 50번째 항목 이후의 모든 모델을 사용할 수 있다는 뜻은 아닙니다. 전체 모델 ID로 최소한의 요청을 보내고, APIYI 호출 로그에서 전달 여부, 상태 코드, 오류 세부 정보를 확인합니다.

현재 50개 항목 제한을 변경하는 `config.yaml` 설정은 없습니다. 같은 Hermes 버전, 프로필, 제공업체, 캐시를 사용하는데도 데스크톱과 CLI의 개수가 계속 다르면 제공업체 이름, 전체 모델 ID, Hermes 백엔드 버전, 호출 로그를 기록합니다. 로그를 공유하기 전에 API 키를 삭제합니다.

## 관련 문서

* [Hermes Agent를 APIYI에 연결하기](/ko/scenarios/agent/hermes-agent)
* [적합한 AI 모델은 어떻게 선택하나요?](/ko/faq/model-selection-guide)
* [일부 모델을 사용할 수 없는 이유는 무엇인가요?](/ko/faq/model-availability)
* [호출 기록은 어떻게 확인하나요?](/ko/faq/call-logs)

Hermes의 공식 참고 자료는 `hermes-agent.nousresearch.com/docs/user-guide/desktop`, `hermes-agent.nousresearch.com/docs/user-guide/configuring-models`, `hermes-agent.nousresearch.com/docs/reference/model-catalog`를 참조하세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.