Połącz OpenHands z CheapTokens: model, Base URL, klucz

Możesz uruchomić OpenHands na modelu CheapTokens, wypełniając trzy pola w Settings > LLM po włączeniu Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1) i API Key. To cała konfiguracja. Reszta tej strony opisuje, co oznacza każde pole i jak wygląda sytuacja, gdy jedno z nich jest błędne.

Nazwy pól i reguła ciągu modelu pochodzą ze strony dokumentacji OpenHands o endpointach zgodnych z OpenAI (sprawdzonej 8 listopada 2026; strona nie ma daty ani wersji). Najnowsze wydanie OpenHands na ten dzień to v1.37.0 (6 listopada 2026). Jeśli etykieta w Twojej kompilacji wygląda nieco inaczej, kieruj się pozycją: model, base URL, klucz.

Zanim otworzysz Settings#

Trzy rzeczy pod ręką oszczędzą Ci rundy: klucz, identyfikator modelu i dostęp do Settings.

Nowy w kluczach i base URL? Czym jest base_url i jak go przełączyć omawia to w kilka minut, a lista modeli z GET /v1/models pokazuje, jak samodzielnie sprawdzić identyfikator.

Trzy pola#

Otwórz Settings > LLM i włącz Advanced. Pole Base URL znajduje się pod przełącznikiem Advanced.

Dokumentacja opisuje regułę modelu tak: Custom Model to openai/, po którym następuje nazwa modelu, a jeśli korzystasz z proxy z własnym prefiksem, openai/<proxy-prefix>/<model-name>. Część po openai/ to nazwa modelu. Dla CheapTokens identyfikator to deepseek-ai/DeepSeek-V4-Flash-0731, więc pełny ciąg to openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Dlaczego ten model dla agenta? DeepSeek-V4-Flash ma okno kontekstu 380K i do 32 768 tokenów wyjściowych na odpowiedź oraz jedną cenę o każdej porze, więc długa sesja nie drożeje w godzinach szczytu. Agent kodujący ponownie wysyła dużo kontekstu na każdym kroku i właśnie do tego służy okno.

Wolisz GLM? Użyj openai/zai-org/GLM-5.3-Flash (kontekst 390K, do 8 192 tokenów wyjściowych) w tym samym polu i nie zmieniaj niczego innego. To samo saldo, ten sam klucz, ten sam Base URL.

Najpierw sprawdź elementy poza OpenHands#

Zanim obwinisz agenta, wyślij jedno żądanie z tym samym URL, kluczem i identyfikatorem. Jeśli to działa, każdy pozostały problem tkwi w sposobie wpisania pól.

curl https://api.cheaptokens.dev/v1/chat/completions \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"deepseek-ai/DeepSeek-V4-Flash-0731","messages":[{"role":"user","content":"Say ready"}],"max_tokens":20}'

Zauważ, czego brakuje: w wartości model nie ma openai/. Ten prefiks jest dla OpenHands, nie dla API. Odpowiedź zawiera blok usage z prompt_tokens i completion_tokens — te same dwie liczby, które później zobaczysz sumujące się w trakcie sesji agenta.

Jak wygląda błędne pole#

Każde z trzech pól może być przyczyną:

• Błędny klucz. API odpowiada 401 — klucz jest brakujący, błędnie wpisany lub ma końcową spację od kopiowania.
• Błędny Base URL. Żądanie trafia w złe miejsce i dostajesz 404 lub błąd połączenia. Adres musi kończyć się na /v1 i nie zawierać dodatkowej ścieżki.
• Błędny ciąg modelu. Albo brakuje prefiksu, albo identyfikator po nim nie jest pełnym identyfikatorem (API akceptuje tylko pełny gateway_id, nie krótki identyfikator jak deepseek-v4-flash-0731).

Pełne uzasadnienie 401 versus 404 znajduje się w API 401 lub 404: błędny klucz, base URL lub identyfikator modelu.

Ile kosztuje jedna sesja#

Agent rozlicza cały kontekst na każdym kroku, a nie Twoje jednolinijkowe zadanie. Załóżmy, że OpenHands pracuje nad błędem przez 40 kroków, z około 30 000 tokenów wysłanych i 1 500 zapisanych z powrotem na krok. Jeden krok na DeepSeek-V4-Flash to $0.0006; czterdzieści z nich jest poniżej, obok innych modeli i OpenRouter.

Łącznie, licząc wejście i wyjście razem, DeepSeek-V4-Flash wypada taniej niż OpenRouter dla tego obciążenia. Założenia są do zmiany: krótka poprawka może zająć 10 kroków, duży refaktor 100. Aktualne ceny są na stronie cenowej, a strona modelu to tani DeepSeek.

Korzystasz już z OpenHands z innym dostawcą?#

Wtedy podmieniasz tylko trzy wartości: Custom Model, Base URL, API Key. Nic innego w projekcie się nie zmienia, a wrócić możesz w ten sam sposób. Krok po kroku połączenie z samym API jest w dokumentacji CheapTokens; podobna konfiguracja w innym narzędziu to połącz Aider.