Collega OpenHands a CheapTokens: modello, Base URL, chiave

Puoi eseguire OpenHands su un modello CheapTokens compilando tre campi in Settings > LLM dopo aver attivato Advanced: Custom Model (openai/deepseek-ai/DeepSeek-V4-Flash-0731), Base URL (https://api.cheaptokens.dev/v1) e API Key. Tutta la configurazione è qui. Il resto di questa pagina spiega cosa significa ogni campo e come si presenta quando uno di essi è sbagliato.

I nomi dei campi e la regola sulla stringa del modello provengono dalla pagina della documentazione di OpenHands sugli endpoint compatibili con OpenAI (verificata l'8 novembre 2026; la pagina non riporta data né versione). L'ultima release di OpenHands a quella data è la v1.37.0 (6 novembre 2026). Se un'etichetta nella tua build appare leggermente diversa, orientati per posizione: modello, base URL, chiave.

Prima di aprire Settings#

Tre cose a portata di mano ti risparmieranno un giro a vuoto: la chiave, l'id del modello e l'accesso a Settings.

Nuovo alle chiavi e ai base URL? Cos'è base_url e come cambiarlo lo spiega in pochi minuti, e elencare i modelli con GET /v1/models mostra come cercare un id da solo.

I tre campi#

Apri Settings > LLM e attiva Advanced. Il campo Base URL si trova sotto l'interruttore Advanced.

La documentazione descrive così la regola del modello: Custom Model è openai/ seguito dal nome del modello, e se passi attraverso un proxy che ha il proprio prefisso, openai/<proxy-prefix>/<model-name>. La parte dopo openai/ è il nome del modello. Per CheapTokens l'id è deepseek-ai/DeepSeek-V4-Flash-0731, quindi la stringa completa è openai/deepseek-ai/DeepSeek-V4-Flash-0731.

Perché questo modello per un agente? DeepSeek-V4-Flash ha una finestra di contesto di 380K e fino a 32.768 token di output per risposta, e un unico prezzo a qualsiasi ora, così una sessione lunga non costa di più nelle ore di punta. Un agente di coding reinvia molto contesto a ogni passo, ed è a questo che serve la finestra.

Preferisci GLM? Usa openai/zai-org/GLM-5.3-Flash (390K di contesto, fino a 8.192 token di output) nello stesso campo e non cambiare altro. Stesso saldo, stessa chiave, stesso Base URL.

Verifica prima i pezzi fuori da OpenHands#

Prima di dare la colpa all'agente, invia una richiesta con lo stesso URL, la stessa chiave e lo stesso id. Se funziona, qualsiasi problema rimasto è nel modo in cui hai digitato i campi.

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

Nota cosa manca: non c'è openai/ nel valore model. Quel prefisso è per OpenHands, non per l'API. La risposta contiene un blocco usage con prompt_tokens e completion_tokens — gli stessi due numeri che vedrai poi sommarsi nel corso di una sessione dell'agente.

Come si presenta un campo sbagliato#

Ciascuno dei tre campi può essere la causa:

• Chiave sbagliata. L'API risponde 401 — la chiave manca, è digitata male o ha uno spazio finale dovuto alla copia.
• Base URL sbagliato. La richiesta va nel posto sbagliato e ottieni un 404 o un errore di connessione. L'indirizzo deve terminare con /v1 e non contenere percorsi aggiuntivi.
• Stringa del modello sbagliata. O manca il prefisso, oppure l'id che lo segue non è l'id completo (l'API accetta solo gateway_id completo, non un id abbreviato come deepseek-v4-flash-0731).

Il ragionamento completo su 401 versus 404 è in API 401 o 404: chiave, base URL o id del modello sbagliati.

Quanto costa una sessione#

Un agente fattura l'intero contesto a ogni passo, non il tuo compito da una riga. Supponiamo che OpenHands lavori su un bug per 40 passi, con circa 30.000 token inviati e 1.500 riscritti per passo. Un passo su DeepSeek-V4-Flash costa $0.0006; quaranta passi sono qui sotto, accanto agli altri modelli e a OpenRouter.

In totale, contando insieme input e output, DeepSeek-V4-Flash risulta più economico di OpenRouter per questo carico di lavoro. Le ipotesi puoi cambiarle: una correzione breve può richiedere 10 passi, un grande refactoring 100. I prezzi attuali sono nella pagina dei prezzi, e la pagina del modello è DeepSeek economico.

Usi già OpenHands con un altro provider?#

Allora devi solo scambiare tre valori: Custom Model, Base URL, API Key. Nient'altro nel progetto cambia, e puoi tornare indietro allo stesso modo. La connessione passo passo per l'API stessa è nella documentazione di CheapTokens; una configurazione simile in un altro strumento è collegare Aider.