Collega DeepSeek Harness a CheapTokens: provider personalizzato

Per usare DeepSeek Harness con CheapTokens, apri Settings → Models, passa la scheda a Custom model API, imposta la base URL su https://api.cheaptokens.dev/v1, scegli OpenAI Chat Completions come protocollo, incolla la tua chiave CheapTokens e aggiungi l'id del modello deepseek-ai/DeepSeek-V4-Flash-0731. Seleziona quel modello nel selettore e la tua prossima sessione girerà su di esso.

Questo è tutto il trucco. Il resto di questa pagina è il modulo esatto, una verifica rapida che la chiave funzioni prima di dare la colpa all'app, e una breve lista di cosa controllare quando il gateway dice no.

Le impostazioni seguenti provengono dalla documentazione di Harness al 24 ottobre 2026. Il progetto è in anteprima pubblica, e il suo README avverte che ci saranno cambiamenti che rompono la compatibilità, quindi se un'etichetta si è spostata, fidati dello schermo e della guida del provider.

Cosa stai collegando#

DeepSeek Harness è un agente open-source di DeepSeek (licenza MIT, costruito sull'architettura a plugin Cordis). È disponibile come app desktop per macOS su Apple silicon e Windows 64-bit, oppure come web UI che avvii con npx @deepseek-ai/dsh web (richiede Node.js). La web UI si apre su http://127.0.0.1:3080 per impostazione predefinita.

Di default chiede una chiave DeepSeek. Ma la stessa schermata Models ha una scheda per tutto ciò che non è nel suo catalogo, un relay, un gateway aziendale o un altro provider. Quella scheda è ciò che usiamo.

Dal lato CheapTokens ti servono due cose: una chiave e un saldo. Se non hai ancora creato una chiave, La tua prima richiesta API con CheapTokens richiede un paio di minuti, e Cos'è una chiave API e come conservarla in modo sicuro spiega dove tenerla.

Verifica la chiave prima di aprire Harness#

Una richiesta dal terminale ti dice se la chiave, il saldo e l'id del modello sono a posto. Se questa funziona e Harness no, il problema è nel modulo, non nell'account.

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

Dovresti ottenere una risposta JSON con un array choices e un blocco usage che conta i token di input e output. Un errore in stile Invalid API key indica la chiave; un messaggio sul saldo indica che è necessario una ricarica.

Compila il modulo del provider personalizzato#

Apri Settings → Models e passa la scheda del provider a Custom model API. Compila i campi così:

Due dettagli fanno inciampare le persone. Primo, la base URL è https://api.cheaptokens.dev/v1, esattamente come nel curl sopra meno /chat/completions. Secondo, l'id del modello è quello completo con il prefisso deepseek-ai/. Un nome breve come deepseek-v4-flash non è ciò che l'API si aspetta. Se vuoi il background su base_url e su come cambiarla, vedi API compatibile con OpenAI: cos'è base_url e come cambiarla.

C'è anche un pulsante Fetch available models. La documentazione dice che interroga GET /models e che puoi sempre digitare l'id a mano. Digitarlo è la strada sicura qui, quindi fallo.

Scegli il modello ed esegui un primo task#

Apri il selettore dei modelli e scegli il modello CheapTokens. Selezionare un modello lì lo rende predefinito per le nuove sessioni, così non devi ripeterlo.

Ora dagli qualcosa di piccolo e verificabile. Supponi di avere un progetto con un test che fallisce:

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

Cosa vuoi vedere: l'agente esegue il comando di test, legge il file che fallisce, lo modifica, esegue di nuovo i test e mostra un diff. Se lo fa, la connessione è fatta. Il tuo saldo ora è ciò che paga il ciclo.

Perché un modello economico si adatta a un ciclo di agente#

Un agente non invia una sola domanda. Invia l'intera conversazione, gli elenchi dei file e l'output degli strumenti di nuovo a ogni passo, quindi una sessione è per lo più token di input. Questo è ciò che rende sorprendenti le bollette degli agenti (perché una chat lunga costa di più spiega la meccanica, e Come stimare il costo di un agente AI fornisce il metodo).

Supponi che una sessione abbia 200 passi, ogni passo invia circa 30.000 token di contesto e riceve circa 600 token indietro. Sono 200 × 30.000 = 6.000.000 token di input e 200 × 600 = 120.000 token di output. Su DeepSeek-V4-Flash quella sessione costa $0.102 ai prezzi odierni, ed è più economica di OpenRouter in totale, con input e output contati insieme. La tabella sotto usa lo stesso carico di lavoro per ogni modello che offriamo:

Per sessioni lunghe DeepSeek-V4-Flash ti dà una finestra di contesto di 380K, fino a 32.768 token in una risposta, e un prezzo a qualsiasi ora: nessun sovrapprezzo nelle ore di punta. Usa lo stesso saldo di ogni altro modello CheapTokens, quindi puoi cambiare modello in Harness senza ricaricare di nuovo. Le tariffe attuali sono sulla pagina dei prezzi, e la pagina del modello ha altro sulla linea DeepSeek.

Preferisci mantenere la sessione più leggera? Aggiungi zai-org/GLM-5.3-Flash (contesto 390K, fino a 8.192 token di output) o MiniMaxAI/MiniMax-M2.7 (contesto 180K, fino a 8.192 token di output) allo stesso provider come id di modelli extra. Un provider può contenere diversi modelli, e il selettore ti permette di passare tra loro.

Se non funziona#

La documentazione di Harness elenca i soliti sospetti. Eccoli con cosa fare:

• Il gateway rifiuta ogni richiesta anche se la chiave e la URL sono corrette. La forma della richiesta differisce da ciò che l'endpoint si aspetta. Harness ha impostazioni di compatibilità per modello, come il ruolo usato per il prompt di sistema o il nome del campo dei token di output. Si trovano in $DSH_HOME/profiles/<profile>/cordis.patch.yml e si ricaricano senza riavvio. Prendi le chiavi esatte dalla guida del provider invece di indovinarle.
• Il menu effort manca per il modello che hai digitato. Harness mostra i livelli di ragionamento solo per i modelli che li dichiarano. Un modello inserito a mano non ne ha dichiarati, quindi il menu resta vuoto. Dichiarare i livelli fa parte dello stesso file di impostazioni per modello.
• 401 durante il recupero dei modelli. Controlla la chiave, oppure salta il pulsante e inserisci l'id del modello da solo.
• Una risposta si interrompe a metà frase. È un limite di token, non una connessione rotta; vedi perché una risposta AI si interrompe a metà frase.
• Un 401 o 403 nel log dalla prima richiesta. Ripeti il controllo curl sopra con la stessa chiave. Se curl funziona, ridigita la chiave nel campo Credential; uno spazio in più alla fine è un classico.

Se usi già un altro agente con la stessa chiave, collegare OpenCode segue lo stesso schema, e la documentazione CheapTokens elenca ogni endpoint. Un altro strumento nello stesso cassetto, un saldo.

Prima di chiudere la scheda#

• Base URL: https://api.cheaptokens.dev/v1
• Protocollo: OpenAI Chat Completions
• Id del modello: deepseek-ai/DeepSeek-V4-Flash-0731
• Chiave: dal tuo account CheapTokens, tenuta fuori da screenshot e repository

Esegui il task del test che fallisce una volta e osserva l'utilizzo sul tuo saldo. Quella singola esecuzione ti dice quanto costano le tue sessioni.