Come collegare OpenCode a CheapTokens (opencode.json)

Per collegare OpenCode a CheapTokens, aggiungi un provider personalizzato compatibile con OpenAI: memorizza la tua chiave API con /connect (ID provider cheaptokens), poi descrivi il provider in opencode.json con l'URL di base https://api.cheaptokens.dev/v1. Dopodiché i tuoi modelli CheapTokens compaiono in /models.

Questa guida segue la documentazione dei provider di OpenCode (pagina aggiornata il 20 ottobre 2026; verificata il 22 ottobre 2026). Lo stesso approccio funziona per gli altri strumenti di questa serie: Cline, Aider e Kilo Code.

Cosa ti serve#

• OpenCode installato (vedi la sua documentazione per la tua piattaforma).
• Una chiave API CheapTokens. Creane una nel tuo account e ricarica il saldo; un saldo copre tutti i modelli. Le basi sono nella documentazione CheapTokens.
• I dati dell'API:
  • URL di base: https://api.cheaptokens.dev/v1
  • compatibilità: OpenAI Chat Completions e Anthropic Messages
  • ID modello usato di seguito: deepseek-ai/DeepSeek-V4-Flash-0731 (contesto 380K, fino a 32.768 token di output). Gli ID dei modelli sono elencati nella documentazione CheapTokens: i nomi differiscono tra i provider, quindi copia l'ID da lì.

Passo 1. Memorizza la chiave con /connect#

1. Avvia OpenCode nel tuo progetto ed esegui /connect.
2. Scorri fino a Other.
3. Inserisci un ID provider univoco: cheaptokens.
4. Incolla la tua chiave API CheapTokens.

Questo passo memorizza solo la credenziale. OpenCode non conosce ancora l'indirizzo o i modelli del provider: è a questo che serve opencode.json.

Passo 2. Descrivi il provider in opencode.json#

Crea o modifica opencode.json e aggiungi il provider. L'ID provider in provider deve corrispondere a quello che hai inserito in /connect.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "cheaptokens": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "CheapTokens",
      "options": {
        "baseURL": "https://api.cheaptokens.dev/v1"
      },
      "models": {
        "deepseek-ai/DeepSeek-V4-Flash-0731": {
          "name": "DeepSeek-V4-Flash",
          "limit": {
            "context": 380000,
            "output": 32768
          }
        }
      }
    }
  }
}

Cosa fa ogni parte:

• npm — @ai-sdk/openai-compatible è il pacchetto per gli endpoint che usano /v1/chat/completions, che è ciò che espone CheapTokens. (OpenCode usa @ai-sdk/openai per gli endpoint basati su /v1/responses.)
• name — l'etichetta mostrata nell'interfaccia di OpenCode.
• options.baseURL — l'indirizzo dell'API CheapTokens.
• models — con chiave l'ID del modello; il name all'interno è un nome visualizzato.
• limit.context / limit.output — opzionali; indicano a OpenCode la finestra di contesto del modello e la lunghezza massima della risposta.

Tieni invece la chiave in una variabile d'ambiente (opzionale)#

Se preferisci non tenere la chiave nell'archivio delle credenziali di OpenCode, aggiungi apiKey a options con la sintassi {env:VARIABLE} consigliata dalla documentazione:

"options": {
  "baseURL": "https://api.cheaptokens.dev/v1",
  "apiKey": "{env:CHEAPTOKENS_API_KEY}"
}

Poi esporta CHEAPTOKENS_API_KEY nella tua shell. Non fare il commit di una chiave reale nel repository. Se sei nuovo alle chiavi, leggi cos'è una chiave API e come conservarla in modo sicuro.

Passo 3. Verifica che funzioni#

Esegui /models e scegli DeepSeek-V4-Flash sotto il provider CheapTokens. Poi invia un prompt breve, ad esempio: "Riassumi in tre frasi cosa fa questo repository." Una risposta normale significa che l'URL di base, la chiave e l'ID del modello sono tutti corretti.

Quale modello CheapTokens scegliere#

Aggiungi tutte le voci che vuoi a models — ognuna è un blocco come quello sopra, con il proprio ID.

Per una sessione OpenCode, che invia molte richieste in un ciclo, DeepSeek-V4-Flash è un buon default: l'output costa meno del prezzo di riferimento di OpenRouter, le risposte possono raggiungere 32.768 token e il prezzo non ha ore di punta. Anche MiniMax-M2.7 costa meno dei prezzi di riferimento di OpenRouter sia in input che in output. Anche l'output di GLM-5.3-Flash costa meno del prezzo di riferimento di OpenRouter. Prezzi attuali (verificati dal vivo, nessun numero che diventi obsoleto):

Per stimare una sessione di lavoro, ad esempio 20 richieste con 100.000 token di input e 5.000 di output ciascuna:

Vedi tutti i prezzi e la pagina DeepSeek per saperne di più.

Se non funziona#

• Il provider o i modelli mancano da /models. Controlla che opencode.json sia JSON valido (nessuna virgola finale) e che la chiave sotto provider sia esattamente l'ID che hai inserito in /connect. Se entrambi sono corretti, riavvia OpenCode.
• 401 / errore di autenticazione. Esegui di nuovo /connect e incolla di nuovo la chiave, oppure controlla la variabile CHEAPTOKENS_API_KEY nella shell in cui viene avviato OpenCode.
• 404 o "model not found". L'ID del modello in models deve corrispondere carattere per carattere all'ID CheapTokens, incluso il prefisso del fornitore (deepseek-ai/…).
• Errori di connessione. L'URL di base deve terminare con /v1 e non contenere percorsi aggiuntivi. Vedi errori di connessione comuni.
• "Not enough tokens". Ricarica il saldo; vedi cosa significa l'errore.

Prossimi passi#

Ora hai OpenCode in esecuzione su CheapTokens con un saldo per tutti i modelli. Ottieni una chiave e fai la tua prima chiamata dalla documentazione CheapTokens.