Hermes Agent

Uruchom Hermes Agent przez jego opcję własnego endpointu zgodnego z OpenAI.

Hermes Agent od Nous Research

Co działa

Hermes łączy się z OneProvider przez własnego dostawcę w trybie Chat Completions, ze zgodnym ID modelu wybranym z katalogu.

Ograniczenie klienta

Zostaw tryb API ustawiony na Chat Completions; inne tryby dostawców Hermes nie korzystają z tego połączenia zgodnego z OpenAI.

Konfiguracja

1. Otwórz konfigurację modelu w Hermes

   Uruchom kreator modelu i wybierz Custom endpoint (self-hosted / VLLM / etc.).

   hermes model

2. Wpisz połączenie z OneProvider

   Podaj https://api.oneprovider.dev/v1, swój dedykowany klucz OneProvider, zgodne ID modelu wybrane z katalogu oraz Chat Completions jako tryb API.

   Endpoint: https://api.oneprovider.dev/v1
   API key: sk-your-key-here
   Model: gpt-6.1-terra
   Mode: Chat Completions

3. Albo skonfiguruj Hermes ręcznie

   Zapisz ONEPROVIDER_API_KEY=… w ~/.hermes/.env, a potem ustaw blok model w ~/.hermes/config.yaml.

   # ~/.hermes/.env
   ONEPROVIDER_API_KEY=sk-your-key-here
   # ~/.hermes/config.yaml
   model:
   default: gpt-6.1-terra
   provider: custom
   base_url: https://api.oneprovider.dev/v1
   key_env: ONEPROVIDER_API_KEY

Sprawdź połączenie

Rozpocznij nową sesję Hermes

Zadaj krótkie pytanie, a potem potwierdź w Panelu OneProvider skonfigurowane ID modelu, zużycie tokenów i rozliczoną opłatę.

Dane połączenia

Protokół

openai-chat

Endpoint

https://api.oneprovider.dev/v1

Bezpieczeństwo klucza

Użyj dedykowanego klucza inferencji ograniczonego do potrzebnego modelu, z kontrolą szybkości, wydatków i ważności. Trzymaj klucz w ~/.hermes/.env, a nie w config.yaml.

Jaki model wybrać

Ustaw default w bloku model pliku config.yaml. gpt-6.1-terra to dobry wybór domyślny na co dzień, gpt-6.1-sol to poziom frontier do trudnych zadań, a gpt-5.6-luna jest tani do szybkich zadań lub dużych wolumenów. Jako tryb API wybierz Chat Completions i kopiuj ID ze strony modeli .

Częste błędy i rozwiązania

401

Klucz nie jest odczytywany: sprawdź, czy ONEPROVIDER_API_KEY=… jest w ~/.hermes/.env i czy key_env w config.yaml wskazuje tę samą zmienną.

404

base_url musi mieć postać https://api.oneprovider.dev/v1 z /v1.

„Model not found”

ID nie ma w katalogu albo jest w nim literówka. Skopiuj je ze strony modeli.

429 „Insufficient balance”

Saldo lub limit klucza został wyczerpany. Doładuj saldo.

Kreator nie pokazuje OneProvider

Wybierz Custom endpoint w hermes model: OneProvider dodaje się jako własny endpoint zgodny z OpenAI.

FAQ

Gdzie trzymać klucz?

W ~/.hermes/.env, a nie w config.yaml.

Czy mogę używać modeli Claude?

Tak, wpisz ID Claude, na przykład claude-sonnet-5-5, w tym samym własnym endpoincie; możliwości zależą od modelu.

Jak sprawdzić, że to działa?

Rozpocznij nową sesję, zadaj krótkie pytanie i znajdź zapytanie na stronie Zużycie w Panelu.

Szybkie odpowiedzi

Jakiego base URL użyć?

Claude Code i SDK Anthropic używają https://api.oneprovider.dev. SDK OpenAI i klienty zgodne z OpenAI używają https://api.oneprovider.dev/v1. Jeden klucz działa przy obu; lista modeli jest na stronie modeli , a stawki na stronie cennika .

Jak się uwierzytelnić?

Wyślij surowy klucz sk-… w x-api-key albo Authorization: Bearer: w jednym z nich, nigdy w obu. Trzymaj klucz w zmiennej środowiskowej, a nie w pliku, który trafia do repozytorium. Więcej o uwierzytelnianiu .

Skąd wziąć klucz?

Otwórz swój Panel w bocie Telegram @oneprovider_robot lub na app.oneprovider.dev, doładuj saldo i naciśnij „Utwórz klucz”. Każdy klucz może mieć własny limit wydatków. Panel i klucze API .

Co oznaczają 401, 404 i 429?

401: klucza brakuje, jest błędnie wpisany albo wysłany w złym nagłówku; wklej cały klucz bez cudzysłowów i spacji. 404: zwykle zły base URL, na przykład brakujące lub podwojone /v1. 429 z komunikatem „Insufficient balance”: saldo Panelu lub limit wydatków klucza się wyczerpał, więc doładuj zamiast ponawiać; każde inne 429 to limit zapytań, więc poczekaj zgodnie z Retry-After. Szczegóły: kody błędów i rozwiązywanie problemów .

Dlaczego strumienie się urywają lub resetują?

VPN i proxy VLESS często buforują SSE albo zrywają negocjację HTTP/2. OneProvider nie ma ograniczeń regionalnych i nie buforuje strumieni, więc wyłącz proxy i spróbuj ponownie.

Gdzie pytać, jeśli to nie wystarcza?

Napisz do @Oneproviderhelpbot w Telegramie albo otwórz „Wsparcie” w Panelu w przeglądarce, podając kod statusu HTTP i dokładny komunikat błędu. Jak działa wsparcie .