Costo API per feature: tre numeri prima di pubblicare

Il costo di una feature AI si calcola con tre numeri: token di input, token di output e prezzo per milione di token. Il resto sono ipotesi, e le ipotesi non passano un budget.

Tre numeri, non uno

• Costo per chiamata: input più output di una singola richiesta.
• Chiamate per utente al mese: leggilo nel log, non stimarlo dal prodotto.
• Costo per feature: chiamate totali per costo unitario, più riprove ed errori.

Il conto, in codice

const MODELS = {
  mini: { input: 0.4, output: 1.6 },
  reasoning: { input: 1.1, output: 4.4 },
  sonnet: { input: 3, output: 15 },
};

export function costPerCall(model, inputTokens, outputTokens) {
  const price = MODELS[model];
  return (inputTokens * price.input + outputTokens * price.output) / 1_000_000;
}

for (const name of Object.keys(MODELS)) {
  const one = costPerCall(name, 3000, 400);
  console.log(name, one.toFixed(5), (one * 10000).toFixed(2));
}

Con 3.000 token di input e 400 di output, una chiamata costa 0,00184 USD su gpt-4.1-mini, 0,00506 su o4-mini e 0,015 su claude-sonnet-4-6. Diecimila chiamate al mese fanno 18,40, 50,60 e 150,00 USD. Salva il blocco in cost.mjs e lancialo con node cost.mjs.

Il listino in tabella

La differenza fra il modello piccolo e quello di ragionamento è di 2,75 volte sulla stessa chiamata: 0,00506 diviso 0,00184. Prima di pagarla, un test sul set di casi deve mostrare che il modello più caro risolve casi che l'altro sbaglia.

Il contesto è la voce più cara

Ogni turno rimanda tutta la conversazione: dieci turni da 3.000 token di storico producono un totale di 165.000 token inviati, non 30.000, perché la somma cresce con il quadrato dei turni. Riassumere lo storico o tagliarlo costa meno che passare a un modello più piccolo.

Cosa resta fuori

• Embedding e immagini: si pagano a parte, con listini diversi.
• Riprove ed errori: un retry dopo un timeout raddoppia quel turno.
• Valutazioni e test: ogni run di eval consuma token come la produzione.

La limitazione

Il conto vale per un modello e un provider precisi, e il listino cambia senza preavviso: 0,40 e 1,60 USD per milione sono il valore letto il 1 novembre 2026, non una promessa. La stima dei token a partire dai caratteri è approssimativa, e i token di ragionamento di un modello reasoning si pagano come output ma non compaiono nel testo.

Dove continuare

Il costo di un task completo è in costi per task di un agente, il peso del contesto lungo in contesto lungo e costi, il confronto misurato fra modelli in valutare un modello per il codice. Per mostrare il conto servono una pricing table o una data table di progetto, dentro componenti dashboard e 111.985 componenti.