DeepSeek Harness mit CheapTokens verbinden: Custom Provider

Um DeepSeek Harness mit CheapTokens zu nutzen, öffne Settings → Models, stelle die Karte auf Custom model API um, setze die Base URL auf https://api.cheaptokens.dev/v1, wähle OpenAI Chat Completions als Protokoll, füge deinen CheapTokens-Key ein und trage die Model-ID deepseek-ai/DeepSeek-V4-Flash-0731 hinzu. Wähle dieses Modell im Picker aus, und deine nächste Session läuft damit.

Das ist der ganze Trick. Der Rest dieser Seite ist das exakte Formular, ein schneller Check, ob der Key funktioniert, bevor du die App beschuldigst, und eine kurze Liste, worauf du schauen solltest, wenn das Gateway ablehnt.

Die folgenden Einstellungen stammen aus den Harness-Docs vom 24. Oktober 2026. Das Projekt befindet sich in der öffentlichen Vorschau, und sein README warnt, dass kompatibilitätsbrechende Änderungen kommen werden. Wenn ein Label also verschoben wurde, vertraue dem Bildschirm und dem Provider-Leitfaden.

Was du verbindest#

DeepSeek Harness ist ein Open-Source-Agent von DeepSeek (MIT-Lizenz, aufgebaut auf der Cordis-Plugin-Architektur). Es gibt ihn als Desktop-App für macOS auf Apple Silicon und Windows 64-Bit oder als Web-UI, die du mit npx @deepseek-ai/dsh web startest (Node.js erforderlich). Die Web-UI öffnet standardmäßig unter http://127.0.0.1:3080.

Out of the box fragt es nach einem DeepSeek-Key. Aber derselbe Models-Bildschirm hat eine Karte für alles, was nicht in seinem Katalog steht: ein Relay, ein Firmen-Gateway oder ein anderer Anbieter. Diese Karte nutzen wir.

Auf der CheapTokens-Seite brauchst du zwei Dinge: einen Key und ein Guthaben. Wenn du noch keinen Key erstellt hast, dauert Your first API request with CheapTokens ein paar Minuten, und What is an API key and how to store it safely behandelt, wo du ihn aufbewahrst.

Prüfe den Key, bevor du Harness öffnest#

Eine Anfrage aus dem Terminal sagt dir, ob der Key, das Guthaben und die Model-ID in Ordnung sind. Wenn das funktioniert und Harness nicht, liegt das Problem im Formular, nicht im Konto.

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."}]
  }'

Du solltest eine JSON-Antwort mit einem choices-Array und einem usage-Block erhalten, der die Input- und Output-Tokens zählt. Ein Fehler im Stil von Invalid API key bedeutet der Key; eine Meldung zum Guthaben bedeutet, dass ein Aufladen fällig ist.

Fülle das Custom-Provider-Formular aus#

Öffne Settings → Models und stelle die Provider-Karte auf Custom model API um. Fülle die Felder so aus:

Zwei Details bringen Leute zum Stolpern. Erstens ist die Base URL https://api.cheaptokens.dev/v1, genau wie im curl oben, nur ohne /chat/completions. Zweitens ist die Model-ID die vollständige mit dem Präfix deepseek-ai/. Ein kurzer Name wie deepseek-v4-flash ist nicht das, was die API erwartet. Wenn du den Hintergrund zu base_url und zum Wechseln wissen willst, siehe OpenAI-compatible API: what base_url is and how to switch.

Es gibt außerdem einen Button Fetch available models. Die Docs sagen, dass er GET /models abfragt und dass du die ID immer von Hand eingeben kannst. Sie von Hand einzugeben ist hier der sichere Weg, also mach das.

Wähle das Modell und starte eine erste Aufgabe#

Öffne den Model-Picker und wähle das CheapTokens-Modell. Wenn du dort ein Modell auswählst, wird es zum Standard für neue Sessions, sodass du es nicht wiederholen musst.

Gib ihm jetzt etwas Kleines und Überprüfbares. Angenommen, du hast ein Projekt mit einem fehlschlagenden Test:

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

Was du sehen willst: Der Agent führt den Testbefehl aus, liest die fehlschlagende Datei, bearbeitet sie, führt die Tests erneut aus und zeigt einen Diff. Wenn er das tut, ist die Verbindung fertig. Dein Guthaben bezahlt jetzt die Schleife.

Warum ein günstiges Modell zu einer Agent-Schleife passt#

Ein Agent sendet nicht eine Frage. Er sendet die gesamte Konversation, die Dateilistings und die Tool-Ausgabe bei jedem Schritt erneut, sodass eine Session überwiegend aus Input-Tokens besteht. Das macht Agent-Rechnungen überraschend (why a long chat costs more erklärt die Mechanik, und How to estimate the cost of an AI agent liefert die Methode).

Angenommen, eine Session hat 200 Schritte, jeder Schritt sendet etwa 30.000 Tokens Kontext und bekommt etwa 600 Tokens zurück. Das sind 200 × 30.000 = 6.000.000 Input-Tokens und 200 × 600 = 120.000 Output-Tokens. Auf DeepSeek-V4-Flash kostet diese Session $0.102 zu heutigen Preisen, und insgesamt ist es günstiger als OpenRouter, wenn man Input und Output zusammenzählt. Die Tabelle unten verwendet für jedes Modell, das wir anbieten, dieselbe Arbeitslast:

Für lange Sessions bietet DeepSeek-V4-Flash ein Kontextfenster von 380K, bis zu 32.768 Tokens in einer Antwort und einen Preis zu jeder Stunde: kein Aufschlag zu Stoßzeiten. Es nutzt dasselbe Guthaben wie jedes andere CheapTokens-Modell, sodass du in Harness Modelle wechseln kannst, ohne erneut aufzuladen. Aktuelle Preise stehen auf der pricing page, und die model page hat mehr zur DeepSeek-Reihe.

Du willst die Session lieber leichter halten? Füge zai-org/GLM-5.3-Flash (390K Kontext, bis zu 8.192 Output-Tokens) oder MiniMaxAI/MiniMax-M2.7 (180K Kontext, bis zu 8.192 Output-Tokens) als zusätzliche Model-IDs zum selben Provider hinzu. Ein Provider kann mehrere Modelle halten, und der Picker lässt dich zwischen ihnen wechseln.

Wenn es nicht funktioniert#

Die Harness-Docs listen die üblichen Verdächtigen. Hier sind sie mit dem, was zu tun ist:

• Das Gateway lehnt jede Anfrage ab, obwohl Key und URL stimmen. Die Anfrageform unterscheidet sich von dem, was der Endpoint erwartet. Harness hat Kompatibilitätseinstellungen pro Modell, etwa die Rolle für den System-Prompt oder den Namen des Output-Token-Felds. Sie liegen in $DSH_HOME/profiles/<profile>/cordis.patch.yml und werden ohne Neustart neu geladen. Nimm die exakten Keys aus dem Provider-Leitfaden, statt sie zu raten.
• Das Effort-Menü fehlt für das Modell, das du eingetippt hast. Harness zeigt Reasoning-Stufen nur für Modelle, die sie deklarieren. Ein von Hand eingegebenes Modell hat keine deklariert, also bleibt das Menü leer. Das Deklarieren von Stufen gehört zur selben Einstellungsdatei pro Modell.
• 401 beim Abrufen der Modelle. Prüfe den Key, oder überspringe den Button und gib die Model-ID selbst ein.
• Eine Antwort bricht mitten im Satz ab. Das ist ein Token-Limit, keine kaputte Verbindung; siehe why an AI answer stops mid-sentence.
• Ein 401 oder 403 im Log der ersten Anfrage. Wiederhole den curl-Check oben mit demselben Key. Wenn curl funktioniert, gib den Key im Credential-Feld neu ein; ein verirrtes Leerzeichen am Ende ist ein Klassiker.

Wenn du bereits einen anderen Agent mit demselben Key nutzt, folgt connecting OpenCode demselben Muster, und die CheapTokens docs listen jeden Endpoint. Ein weiteres Tool in derselben Schublade, ein Guthaben.

Bevor du den Tab schließt#

• Base URL: https://api.cheaptokens.dev/v1
• Protocol: OpenAI Chat Completions
• Model id: deepseek-ai/DeepSeek-V4-Flash-0731
• Key: aus deinem CheapTokens-Konto, ferngehalten von Screenshots und Repos

Führe die Aufgabe mit dem fehlschlagenden Test einmal aus und beobachte die Nutzung auf deinem Guthaben. Dieser eine Lauf sagt dir, was deine eigenen Sessions kosten.