Connecter DeepSeek Harness à CheapTokens : fournisseur personnalisé

Pour utiliser DeepSeek Harness avec CheapTokens, ouvrez Settings → Models, basculez la carte sur Custom model API, définissez l'URL de base sur https://api.cheaptokens.dev/v1, choisissez OpenAI Chat Completions comme protocole, collez votre clé CheapTokens et ajoutez l'identifiant de modèle deepseek-ai/DeepSeek-V4-Flash-0731. Sélectionnez ce modèle dans le sélecteur et votre prochaine session tournera dessus.

C'est toute l'astuce. Le reste de cette page, c'est le formulaire exact, une vérification rapide que la clé fonctionne avant d'accuser l'application, et une courte liste de ce qu'il faut regarder quand la passerelle refuse.

Les réglages ci-dessous proviennent de la documentation de Harness au 24 octobre 2026. Le projet est en aperçu public, et son README prévient que des changements cassant la compatibilité auront lieu, donc si un libellé a bougé, faites confiance à l'écran et au guide du fournisseur.

Ce que vous connectez#

DeepSeek Harness est un agent open source de DeepSeek (licence MIT, construit sur l'architecture de plugins Cordis). Il se présente sous forme d'application de bureau pour macOS sur Apple silicon et Windows 64 bits, ou d'une interface web que vous lancez avec npx @deepseek-ai/dsh web (Node.js requis). L'interface web s'ouvre par défaut sur http://127.0.0.1:3080.

Par défaut, il demande une clé DeepSeek. Mais le même écran Models dispose d'une carte pour tout ce qui n'est pas dans son catalogue, un relais, une passerelle d'entreprise ou un autre fournisseur. C'est cette carte que nous utilisons.

Côté CheapTokens, il vous faut deux choses : une clé et un solde. Si vous n'avez pas encore créé de clé, Votre première requête API avec CheapTokens prend quelques minutes, et Qu'est-ce qu'une clé API et comment la stocker en sécurité explique où la garder.

Vérifiez la clé avant d'ouvrir Harness#

Une requête depuis le terminal vous dit si la clé, le solde et l'identifiant de modèle sont bons. Si cela fonctionne et que Harness non, le problème est dans le formulaire, pas dans le compte.

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

Vous devriez obtenir une réponse JSON avec un tableau choices et un bloc usage qui compte les tokens d'entrée et de sortie. Une erreur de style Invalid API key signifie la clé ; un message sur le solde signifie qu'une recharge est nécessaire.

Remplissez le formulaire de fournisseur personnalisé#

Ouvrez Settings → Models et basculez la carte du fournisseur sur Custom model API. Remplissez les champs comme ceci :

Deux détails font trébucher les gens. Premièrement, l'URL de base est https://api.cheaptokens.dev/v1, exactement comme dans le curl ci-dessus moins /chat/completions. Deuxièmement, l'identifiant de modèle est le complet avec le préfixe deepseek-ai/. Un nom court comme deepseek-v4-flash n'est pas ce que l'API attend. Si vous voulez le contexte sur base_url et comment le changer, voir API compatible OpenAI : ce qu'est base_url et comment le changer.

Il y a aussi un bouton Fetch available models. La documentation indique qu'il interroge GET /models et que vous pouvez toujours saisir l'identifiant à la main. Le saisir est la voie sûre ici, alors faites-le.

Choisissez le modèle et lancez une première tâche#

Ouvrez le sélecteur de modèle et choisissez le modèle CheapTokens. Choisir un modèle ici en fait le défaut pour les nouvelles sessions, vous n'avez donc pas à le répéter.

Maintenant, donnez-lui quelque chose de petit et vérifiable. Disons que vous avez un projet avec un test qui échoue :

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

Ce que vous voulez voir : l'agent exécute la commande de test, lit le fichier en échec, le modifie, relance les tests et affiche un diff. S'il fait cela, la connexion est terminée. Votre solde est désormais ce qui paie la boucle.

Pourquoi un modèle bon marché convient à une boucle d'agent#

Un agent n'envoie pas une seule question. Il renvoie toute la conversation, les listes de fichiers et la sortie des outils à chaque étape, donc une session est principalement composée de tokens d'entrée. C'est ce qui rend les factures d'agent surprenantes (pourquoi un long chat coûte plus cher explique la mécanique, et Comment estimer le coût d'un agent IA donne la méthode).

Disons qu'une session compte 200 étapes, chaque étape envoie environ 30 000 tokens de contexte et reçoit environ 600 tokens en retour. Cela fait 200 × 30 000 = 6 000 000 tokens d'entrée et 200 × 600 = 120 000 tokens de sortie. Sur DeepSeek-V4-Flash, cette session coûte $0.102 aux prix actuels, et c'est moins cher qu'OpenRouter au total, entrée et sortie comptées ensemble. Le tableau ci-dessous utilise la même charge de travail pour chaque modèle que nous proposons :

Pour les longues sessions, DeepSeek-V4-Flash vous offre une fenêtre de contexte de 380K, jusqu'à 32 768 tokens en une réponse, et un prix à toute heure : pas de surcoût aux heures de pointe. Il utilise le même solde que tous les autres modèles CheapTokens, vous pouvez donc changer de modèle dans Harness sans recharger à nouveau. Les tarifs actuels sont sur la page de tarification, et la page du modèle en dit plus sur la gamme DeepSeek.

Vous préférez garder la session plus légère ? Ajoutez zai-org/GLM-5.3-Flash (contexte 390K, jusqu'à 8 192 tokens de sortie) ou MiniMaxAI/MiniMax-M2.7 (contexte 180K, jusqu'à 8 192 tokens de sortie) au même fournisseur comme identifiants de modèle supplémentaires. Un fournisseur peut contenir plusieurs modèles, et le sélecteur vous permet de passer de l'un à l'autre.

Si cela ne fonctionne pas#

La documentation de Harness liste les suspects habituels. Les voici avec quoi faire :

• La passerelle refuse chaque requête bien que la clé et l'URL soient correctes. La forme de la requête diffère de ce que l'endpoint attend. Harness dispose de réglages de compatibilité par modèle, comme le rôle utilisé pour le prompt système ou le nom du champ des tokens de sortie. Ils se trouvent dans $DSH_HOME/profiles/<profile>/cordis.patch.yml et se rechargent sans redémarrage. Prenez les clés exactes dans le guide du fournisseur plutôt que de les deviner.
• Le menu d'effort est absent pour le modèle que vous avez saisi. Harness n'affiche les niveaux de raisonnement que pour les modèles qui les déclarent. Un modèle saisi à la main n'en déclare aucun, donc le menu reste vide. Déclarer des niveaux fait partie du même fichier de réglages par modèle.
• 401 lors de la récupération des modèles. Vérifiez la clé, ou sautez le bouton et saisissez l'identifiant de modèle vous-même.
• Une réponse s'arrête en pleine phrase. C'est une limite de tokens, pas une connexion cassée ; voir pourquoi une réponse IA s'arrête en pleine phrase.
• Un 401 ou 403 dans le journal dès la première requête. Répétez la vérification curl ci-dessus avec la même clé. Si curl fonctionne, ressaisissez la clé dans le champ Credential ; un espace parasite à la fin est un classique.

Si vous utilisez déjà un autre agent avec la même clé, connecter OpenCode suit le même schéma, et la documentation CheapTokens liste chaque endpoint. Un outil de plus dans le même tiroir, un seul solde.

Avant de fermer l'onglet#

• URL de base : https://api.cheaptokens.dev/v1
• Protocole : OpenAI Chat Completions
• Identifiant de modèle : deepseek-ai/DeepSeek-V4-Flash-0731
• Clé : depuis votre compte CheapTokens, tenue hors des captures d'écran et des dépôts

Lancez la tâche du test en échec une fois et surveillez l'usage sur votre solde. Cette seule exécution vous dit ce que coûtent vos propres sessions.