Collega n8n a CheapTokens: credenziale OpenAI, Base URL

In n8n, crea una credenziale OpenAI, inserisci https://api.cheaptokens.dev/v1 nel campo Base URL, incolla la tua chiave CheapTokens in API Key e scegli un id modello nel nodo OpenAI Chat Model. Tutto qui: nessun nodo personalizzato, nessun pacchetto della community. I workflow esistenti mantengono i loro nodi e ricevono solo una nuova credenziale.

Funziona perché l'API CheapTokens parla il formato OpenAI Chat Completions (e anche Anthropic Messages), quindi il nodo OpenAI di n8n non può notare la differenza. Se l'idea di "base URL" è nuova per te, questa spiegazione la copre in due minuti.

Cosa ti offre la credenziale n8n#

La credenziale OpenAI di n8n ha quattro cose da compilare. Secondo il codice sorgente della credenziale nel repository n8n (branch master, verificato il 1 novembre 2026), sono: API Key (obbligatoria, mascherata), Organization ID (opzionale), Base URL (predefinito https://api.openai.com/v1, descritto come override dell'indirizzo base dell'API) e un interruttore Add Custom Header con nome e valore dell'header.

Un dettaglio da sapere: la pagina della documentazione ufficiale di n8n per la credenziale OpenAI elenca solo la chiave e l'organization ID. Il campo Base URL è visibile nel codice sorgente, quindi è su quello che si basa questa guida.

Quando salvi, n8n testa la credenziale inviando una richiesta a {Base URL}/models con un header Authorization: Bearer <API Key>. Quindi un Base URL sbagliato o una chiave errata emergono subito, prima che tu costruisca qualsiasi cosa.

Configuralo in quattro passaggi#

Non sai cosa digitare come id modello? Chiedilo all'API stessa: Elenca i modelli con GET /v1/models mostra le stringhe esatte. Provider diversi nominano lo stesso modello in modo diverso, quindi copia l'id da CheapTokens, non dalla documentazione di un altro servizio.

Verifica prima la chiave fuori da n8n#

Se il test della credenziale fallisce, vuoi sapere se il problema è n8n o la chiave. Un breve controllo da terminale risponde. La chiave sta in una variabile d'ambiente, così nulla di segreto finisce nella cronologia.

export CHEAPTOKENS_API_KEY="your-key-here"
curl https://api.cheaptokens.dev/v1/models \
  -H "Authorization: Bearer $CHEAPTOKENS_API_KEY"

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://api.cheaptokens.dev/v1",
    api_key=os.environ["CHEAPTOKENS_API_KEY"],
)
r = client.chat.completions.create(
    model="deepseek-ai/DeepSeek-V4-Flash-0731",
    messages=[{"role": "user", "content": "Reply with one word: ready"}],
    max_tokens=20,
)
print(r.choices[0].message.content, r.usage)

Un primo workflow: smistare le email in arrivo#

Supponiamo che una casella condivisa riceva circa mille email al giorno. Vuoi che ognuna sia etichettata come billing, bug o other, più un riassunto di una riga per chi la prende in carico.

Costruiscilo così: un Gmail Trigger (o un nodo Webhook) alimenta una Basic LLM Chain. Il prompt nella chain dice qualcosa come "Classifica questa email come billing, bug o other, poi riassumila in una frase", con il corpo dell'email inserito dal nodo precedente. Il nodo OpenAI Chat Model sotto di esso, con la tua credenziale CheapTokens, fa il ragionamento.

Il lavoro è breve e ripetitivo: un piccolo input, una piccola risposta, migliaia di esecuzioni identiche. È qui che un modello economico con un prezzo stabile rende di più. Per questo tipo di lavoro in CheapTokens, DeepSeek-V4-Flash ti dà un unico prezzo a qualsiasi ora del giorno, una finestra di contesto di 380K e fino a 32.768 token per risposta.

Quanto costa un'esecuzione#

Supponiamo che ogni email produca un prompt di circa 1.500 token (istruzioni più email) e che il modello scriva circa 300 token in risposta. Un'esecuzione su DeepSeek-V4-Flash costa $0.000053. Per 1.000 email al giorno, ecco tutti i modelli affiancati con OpenRouter, input e output contati insieme:

I conteggi dei token sono un'ipotesi per questo esempio; misura i tuoi inviando un'email tipica attraverso il controllo Python e leggendo usage, poi sostituisci i numeri. I prezzi attuali sono sulla pagina dei prezzi.

Un workflow in stile chat è diverso. Con un nodo di memoria, l'intera cronologia viaggia con ogni chiamata, quindi l'input cresce a ogni messaggio. Perché una lunga chat AI costa di più mostra quanto in fretta si accumula.

Se non funziona#

La maggior parte dei fallimenti è una di tre cose: la chiave, l'indirizzo o l'id modello. API 401 o 404: chiave, base URL o id modello sbagliati analizza ogni testo di errore. Prima di aprirlo, scorri questa lista:

Vuoi vedere il resto della configurazione? La documentazione CheapTokens ha il riferimento completo dell'API, e la pagina DeepSeek elenca i limiti del modello. Usi già un altro strumento con lo stesso schema? Open WebUI e LangChain si collegano allo stesso modo: un indirizzo, una chiave, un id modello.