OpenHands mit CheapTokens verbinden: Modell, Base URL, Key

Du kannst OpenHands auf einem CheapTokens-Modell ausführen, indem du nach dem Aktivieren von Advanced drei Felder in Settings > LLM ausfüllst: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1) und API Key. Das ist die gesamte Einrichtung. Der Rest dieser Seite erklärt, was die einzelnen Felder bedeuten und wie es aussieht, wenn eines davon falsch ist.

Die Feldnamen und die Regel für den Modell-String stammen aus der OpenHands-Dokumentationsseite zu OpenAI-kompatiblen Endpunkten (geprüft am 8. November 2026; die Seite hat kein Datum und keine Version). Die neueste OpenHands-Version zu diesem Datum ist v1.37.0 (6. November 2026). Wenn eine Bezeichnung in deinem Build leicht anders aussieht, halte dich an die Position: Modell, Base URL, Key.

Bevor du Settings öffnest#

Drei Dinge zur Hand zu haben erspart dir einen Umweg: der Key, die Modell-ID und der Zugriff auf Settings.

Neu bei Keys und Base URLs? Was base_url ist und wie man wechselt erklärt es in wenigen Minuten, und Modelle mit GET /v1/models auflisten zeigt, wie du eine ID selbst nachschlägst.

Die drei Felder#

Öffne Settings > LLM und aktiviere Advanced. Das Feld Base URL befindet sich unter dem Advanced-Schalter.

Die Dokumentation beschreibt die Modellregel so: Custom Model ist openai/ gefolgt vom Modellnamen, und wenn du über einen Proxy gehst, der ein eigenes Präfix hat, openai/<proxy-prefix>/<model-name>. Der Teil nach openai/ ist der Modellname. Für CheapTokens ist die ID deepseek-ai/DeepSeek-V4-Flash-0731, also lautet der vollständige String openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Warum dieses Modell für einen Agenten? DeepSeek-V4-Flash hat ein Kontextfenster von 380K und bis zu 32.768 Ausgabe-Tokens pro Antwort sowie einen Preis zu jeder Stunde, sodass eine lange Sitzung zu Stoßzeiten nicht teurer wird. Ein Coding-Agent sendet bei jedem Schritt viel Kontext erneut, und dafür ist das Fenster da.

Lieber GLM? Verwende openai/zai-org/GLM-5.3-Flash (390K Kontext, bis zu 8.192 Ausgabe-Tokens) im selben Feld und ändere sonst nichts. Gleiches Guthaben, gleicher Key, gleiche Base URL.

Prüfe die Teile zuerst außerhalb von OpenHands#

Bevor du den Agenten verantwortlich machst, sende eine Anfrage mit derselben URL, demselben Key und derselben ID. Wenn das funktioniert, liegt jedes verbleibende Problem darin, wie du die Felder eingegeben hast.

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}'

Beachte, was fehlt: Im Wert model gibt es kein openai/. Dieses Präfix ist für OpenHands, nicht für die API. Die Antwort enthält einen usage-Block mit prompt_tokens und completion_tokens — dieselben zwei Zahlen, die du später über eine Agenten-Sitzung aufsummiert siehst.

Wie ein falsches Feld aussieht#

Jedes der drei Felder kann die Ursache sein:

• Falscher Key. Die API antwortet mit 401 — der Key fehlt, ist falsch getippt oder hat ein Leerzeichen am Ende vom Kopieren.
• Falsche Base URL. Die Anfrage geht an die falsche Stelle und du bekommst einen 404 oder einen Verbindungsfehler. Die Adresse muss auf /v1 enden und darf keinen zusätzlichen Pfad enthalten.
• Falscher Modell-String. Entweder fehlt das Präfix, oder die ID danach ist nicht die vollständige ID (die API akzeptiert nur die vollständige gateway_id, keine kurze ID wie deepseek-v4-flash-0731).

Die vollständige Begründung für 401 versus 404 steht in API 401 oder 404: falscher Key, Base URL oder Modell-ID.

Was eine Sitzung kostet#

Ein Agent rechnet bei jedem Schritt den gesamten Kontext ab, nicht nur deine einzeilige Aufgabe. Angenommen, OpenHands arbeitet 40 Schritte lang an einem Bug, mit etwa 30.000 gesendeten Tokens und 1.500 zurückgeschriebenen pro Schritt. Ein Schritt auf DeepSeek-V4-Flash kostet $0.0006; vierzig davon stehen unten, neben den anderen Modellen und OpenRouter.

Insgesamt, mit Eingabe und Ausgabe zusammengerechnet, ist DeepSeek-V4-Flash für diese Arbeitslast günstiger als OpenRouter. Die Annahmen kannst du ändern: Ein kurzer Fix kann 10 Schritte dauern, ein großes Refactoring 100. Aktuelle Preise stehen auf der Preisseite, und die Modellseite ist cheap DeepSeek.

Nutzt du OpenHands bereits mit einem anderen Anbieter?#

Dann tauschst du nur drei Werte aus: Custom Model, Base URL, API Key. Sonst ändert sich im Projekt nichts, und du kannst auf demselben Weg zurückwechseln. Die Schritt-für-Schritt-Verbindung für die API selbst steht in der CheapTokens-Dokumentation; eine ähnliche Einrichtung in einem anderen Tool ist connect Aider.