Hermes 사용자 정의 공급자는 어떤 기본 URL을 사용합니까?
이 가이드에서는 Hermes의 OpenAI 호환 형식과 함께 https://relay-api.getapi.pro/v1를 사용합니다. 키는 동일한 getapi.pro 계정에서 가져와야 합니다.
GET API · 개발자 연동
Hermes Agent 데스크톱 첫 실행 흐름은 API 모델을 구성할 수 있습니다. 공식 업스트림 또는 관련 중국 커뮤니티 프로젝트의 현재 공개 릴리스 채널에서 설치합니다. 모델 설정에서 대상 모델에 도달하는 Get API 키를 생성하고, OpenAI 호환 사용자 정의 공급자를 추가하고, https://relay-api.getapi.pro/v1 및 키를 입력하고, 모델 목록을 새로 고치고, 모델을 선택하고, 워크벤치에서 확인합니다. 버전과 UI는 변경될 수 있습니다. 이 페이지는 2026-09-05의 리뷰를 반영합니다.
Hermes에는 공식 업스트림 데스크톱 애플리케이션과 커뮤니티에서 유지 관리하는 중국어 데스크톱 빌드가 있습니다. 버전과 화면은 다를 수 있습니다. 선택한 프로젝트의 현재 공개 릴리스 채널에서 설치하고 운영 체제, 아키텍처 및 릴리스 노트를 확인하세요. Get API는 설치 프로그램을 복사하지 않습니다.
참조 데스크톱 빌드는 이름, 프로토콜 형식, 기본 URL 및 API 키를 사용하여 사용자 지정 공급자를 추가할 수 있습니다. 이름은 단지 레이블일 뿐입니다. 기본 URL과 키는 동일한 Get API 서비스에서 나와야 하며, 목록을 새로 고친 후 모델을 선택해야 합니다.
저장된 양식은 인증 및 라우팅을 증명하지 않습니다. 먼저 모델 목록을 새로 고치십시오. 사용 가능한 모델을 반환한 후 하나를 선택하여 추가한 다음 워크벤치에서 간단한 작업을 보냅니다.
스크린샷은 검증된 Hermes Agent 중국 커뮤니티 데스크톱 흐름을 보여줍니다. 다른 배포판에서는 위치가 다를 수 있습니다.
공식 업스트림 또는 중국 커뮤니티 프로젝트에서 운영 체제 및 아키텍처에 맞는 현재 설치 프로그램을 선택하세요. 소스를 확인하고 설치한 후 처음 실행 시 모델 API 설정을 엽니다.

기본 사이트 콘솔에서 키를 생성하고 대상 GPT 모델에 도달하는 현재 그룹을 선택합니다. 이전 스크린샷의 고정된 그룹 라벨에 의존하지 마세요.

Hermes 첫 실행 화면으로 돌아가서 모델 구성을 선택한 후 사용자 지정 공급자로 계속 진행하세요.

OpenAI 호환 형식을 선택하고 Get API 기본 URL 및 키를 입력한 후 모델 목록을 새로 고친 후 현재 사용 가능한 모델을 선택하세요.

모델을 추가 및 선택하고 워크벤치로 돌아와서 간단한 작업을 보냅니다. 모델 새로 고침과 일반 작업 응답이 모두 성공해야 합니다.

OpenAI 호환 공급자 기본 URL 필드에 이 값을 입력하고 동일한 getapi.pro 계정에서 생성된 키를 사용합니다.
https://relay-api.getapi.pro/v1모델 목록 새로 고침 및 워크벤치 응답을 별도의 체크포인트로 사용하세요.
| 증상 | 가능한 원인 | 액션 | 성공 확인 |
|---|---|---|---|
| 설치 프로그램이 실행되지 않습니다 | 잘못된 시스템이나 아키텍처, 일치하지 않는 소스 | 프로젝트 공개 릴리스 페이지로 돌아가서 시스템, 아키텍처, 메모를 확인하세요. | Hermes가 첫 실행 화면에 도달했습니다. |
| 모델 새로 고침 실패 | 잘못된 키, 기본 URL 또는 프로토콜 형식 | OpenAI 호환성, https://relay-api.getapi.pro/v1, 및 동일한 계정의 키를 확인하세요. | 목록은 접근 가능한 모델을 반환합니다. |
| 모델 목록이 비어 있습니다. | 주요 그룹에 대상 모델 또는 현재 계정 액세스 권한이 없습니다. | 라이브 카탈로그, 주요 그룹 및 계정 상태를 검토하세요. | 승인된 모델을 하나 이상 선택할 수 있습니다. |
| 401 | 불완전하거나 비활성화되었거나 위치가 잘못된 키 | 보안 저장소에서 다시 붙여넣고 키 상태를 확인하세요. | 새로 고침이 더 이상 인증 실패를 반환하지 않습니다. |
| 추가 후 Workbench가 응답하지 않습니다. | 모델이 선택되지 않았거나, 구성이 저장되지 않았거나, 현재 모델이 중단되었습니다. | 모델을 다시 선택하여 저장한 후 최소한의 작업만 전송 | 워크벤치가 정상적인 응답을 받습니다. |
이 가이드에서는 Hermes의 OpenAI 호환 형식과 함께 https://relay-api.getapi.pro/v1를 사용합니다. 키는 동일한 getapi.pro 계정에서 가져와야 합니다.
데스크톱 공급자는 자격 증명이 필요하지만 스크린샷, 공개 소스 제어 또는 지원 messages에 전체 키를 노출하지 마세요. 장치가 더 이상 제어되지 않으면 비활성화하고 회전하십시오.
일반적인 원인은 잘못된 기본 URL, 키 또는 프로토콜 형식이거나 액세스 가능한 모델이 없는 키 그룹입니다. 중복 공급자를 추가하기 전에 이 네 가지 항목을 확인하세요.
아니요. 2026년 9월 5일에 검토된 중국 커뮤니티 데스크톱 흐름을 기록합니다. 공식 업스트림 및 이후 릴리스에서는 필드를 다르게 배치할 수 있습니다.
비즈니스 문의: business@honeykid.cn