Podłącz DeepSeek Harness do CheapTokens: niestandardowy dostawca

Aby używać DeepSeek Harness z CheapTokens, otwórz Settings → Models, przełącz kartę na Custom model API, ustaw base URL na https://api.cheaptokens.dev/v1, wybierz OpenAI Chat Completions jako protokół, wklej swój klucz CheapTokens i dodaj identyfikator modelu deepseek-ai/DeepSeek-V4-Flash-0731. Wybierz ten model w selektorze, a następna sesja będzie na nim działać.

To cała sztuczka. Reszta tej strony to dokładny formularz, szybkie sprawdzenie, czy klucz działa, zanim zaczniesz winić aplikację, oraz krótka lista tego, na co patrzeć, gdy gateway odmawia.

Poniższe ustawienia pochodzą z dokumentacji Harness na dzień 24 października 2026. Projekt jest w publicznym podglądzie, a jego README ostrzega, że zmiany łamiące kompatybilność będą się zdarzać, więc jeśli jakaś etykieta się przeniosła, zaufaj ekranowi i przewodnikowi po dostawcy.

Co podłączasz#

DeepSeek Harness to open-source'owy agent od DeepSeek (licencja MIT, zbudowany na architekturze pluginów Cordis). Jest dostępny jako aplikacja desktopowa dla macOS na Apple silicon i Windows 64-bit albo jako web UI, który uruchamiasz przez npx @deepseek-ai/dsh web (wymagany Node.js). Web UI domyślnie otwiera się pod http://127.0.0.1:3080.

Od razu po instalacji prosi o klucz DeepSeek. Ale ten sam ekran Models ma kartę dla wszystkiego, czego nie ma w jego katalogu: relay, firmowy gateway albo inny dostawca. To właśnie tę kartę wykorzystujemy.

Po stronie CheapTokens potrzebujesz dwóch rzeczy: klucza i salda. Jeśli nie masz jeszcze klucza, Twoje pierwsze żądanie API z CheapTokens zajmie kilka minut, a Czym jest klucz API i jak go bezpiecznie przechowywać omawia, gdzie go trzymać.

Sprawdź klucz, zanim otworzysz Harness#

Jedno żądanie z terminala powie ci, czy klucz, saldo i identyfikator modelu są w porządku. Jeśli to działa, a Harness nie, problem jest w formularzu, nie w koncie.

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 hi in five words."}]
  }'

Powinieneś dostać odpowiedź JSON z tablicą choices i blokiem usage, który zlicza tokeny wejściowe i wyjściowe. Błąd w stylu Invalid API key oznacza klucz; komunikat o saldzie oznacza, że trzeba doładować.

Wypełnij formularz niestandardowego dostawcy#

Otwórz Settings → Models i przełącz kartę dostawcy na Custom model API. Wypełnij pola tak:

Dwa szczegóły potykają ludzi. Po pierwsze, base URL to https://api.cheaptokens.dev/v1, dokładnie jak w powyższym curl bez /chat/completions. Po drugie, identyfikator modelu to pełny identyfikator z prefiksem deepseek-ai/. Krótka nazwa jak deepseek-v4-flash to nie to, czego oczekuje API. Jeśli chcesz poznać podstawy base_url i sposoby jego przełączania, zobacz API zgodne z OpenAI: czym jest base_url i jak go przełączyć.

Jest też przycisk Fetch available models. Dokumentacja mówi, że odpytuje GET /models i że zawsze możesz wpisać identyfikator ręcznie. Wpisanie go ręcznie jest tu bezpieczną ścieżką, więc tak zrób.

Wybierz model i uruchom pierwsze zadanie#

Otwórz selektor modeli i wybierz model CheapTokens. Wybranie modelu w tym miejscu ustawia go jako domyślny dla nowych sesji, więc nie musisz tego powtarzać.

Teraz daj mu coś małego i sprawdzalnego. Załóżmy, że masz projekt z niedziałającym testem:

Run the tests, find why test_parse_date fails and fix it. Show me the diff.

Co chcesz zobaczyć: agent uruchamia polecenie testu, czyta plik, który nie przechodzi, edytuje go, uruchamia testy ponownie i pokazuje diff. Jeśli to robi, połączenie jest gotowe. Twoje saldo jest teraz tym, co płaci za tę pętlę.

Dlaczego tani model pasuje do pętli agenta#

Agent nie wysyła jednego pytania. Wysyła całą rozmowę, listy plików i wyjście narzędzi ponownie na każdym kroku, więc sesja to głównie tokeny wejściowe. To właśnie sprawia, że rachunki za agenta zaskakują (dlaczego długa rozmowa kosztuje więcej wyjaśnia mechanikę, a Jak oszacować koszt agenta AI podaje metodę).

Załóżmy, że sesja ma 200 kroków, każdy krok wysyła około 30 000 tokenów kontekstu i dostaje około 600 tokenów z powrotem. To 200 × 30 000 = 6 000 000 tokenów wejściowych i 200 × 600 = 120 000 tokenów wyjściowych. Na DeepSeek-V4-Flash ta sesja kosztuje $0.102 przy dzisiejszych cenach i jest tańsza niż OpenRouter w sumie, licząc wejście i wyjście razem. Poniższa tabela używa tego samego obciążenia dla każdego modelu, który oferujemy:

W przypadku długich sesji DeepSeek-V4-Flash daje okno kontekstu 380K, do 32 768 tokenów w jednej odpowiedzi i jedną cenę o każdej porze: bez dopłaty w godzinach szczytu. Korzysta z tego samego salda co każdy inny model CheapTokens, więc możesz przełączać modele w Harness bez ponownego doładowywania. Aktualne stawki są na stronie z cennikiem, a strona modelu ma więcej o linii DeepSeek.

Wolisz lżejszą sesję? Dodaj zai-org/GLM-5.3-Flash (kontekst 390K, do 8 192 tokenów wyjściowych) lub MiniMaxAI/MiniMax-M2.7 (kontekst 180K, do 8 192 tokenów wyjściowych) do tego samego dostawcy jako dodatkowe identyfikatory modeli. Jeden dostawca może przechowywać kilka modeli, a selektor pozwala przechodzić między nimi.

Jeśli nie działa#

Dokumentacja Harness wymienia typowych podejrzanych. Oto oni wraz z tym, co zrobić:

• Gateway odrzuca każde żądanie, choć klucz i URL są poprawne. Kształt żądania różni się od tego, czego oczekuje endpoint. Harness ma ustawienia kompatybilności dla poszczególnych modeli, takie jak rola używana dla promptu systemowego czy nazwa pola tokenów wyjściowych. Znajdują się w $DSH_HOME/profiles/<profile>/cordis.patch.yml i przeładowują się bez restartu. Weź dokładne klucze z przewodnika po dostawcy, zamiast ich zgadywać.
• Brak menu effort dla wpisanego modelu. Harness pokazuje poziomy rozumowania tylko dla modeli, które je deklarują. Ręcznie wpisany model nie ma żadnych zadeklarowanych, więc menu pozostaje puste. Deklarowanie poziomów jest częścią tego samego pliku ustawień dla poszczególnych modeli.
• 401 przy pobieraniu modeli. Sprawdź klucz albo pomiń przycisk i wpisz identyfikator modelu samodzielnie.
• Odpowiedź urywa się w połowie zdania. To limit tokenów, nie zerwane połączenie; zobacz dlaczego odpowiedź AI urywa się w połowie zdania.
• 401 lub 403 w logu z pierwszego żądania. Powtórz powyższe sprawdzenie curl z tym samym kluczem. Jeśli curl działa, wpisz klucz ponownie w polu Credential; przypadkowa spacja na końcu to klasyka.

Jeśli używasz już innego agenta z tym samym kluczem, podłączanie OpenCode działa według tego samego schematu, a dokumentacja CheapTokens wymienia każdy endpoint. Jeszcze jedno narzędzie w tej samej szufladzie, jedno saldo.

Zanim zamkniesz kartę#

• Base URL: https://api.cheaptokens.dev/v1
• Protokół: OpenAI Chat Completions
• Identyfikator modelu: deepseek-ai/DeepSeek-V4-Flash-0731
• Klucz: z twojego konta CheapTokens, trzymany z dala od zrzutów ekranu i repozytoriów

Uruchom zadanie z niedziałającym testem raz i obserwuj zużycie na swoim saldzie. Ten jeden przebieg powie ci, ile kosztują twoje własne sesje.