API AI da zero: come funziona, chiavi, costi e prima chiamata

👁 115 letture

Un’API AI permette di interagire con modelli come GPT, Claude e Gemini direttamente da programma, senza passare dall’interfaccia di una chat. Invii una richiesta con la tua chiave, ricevi una risposta in formato JSON e paghi solo per i token effettivamente consumati, in genere frazioni di centesimo a chiamata. Rappresenta il primo passo fondamentale per costruire automazioni e agenti personalizzati: qui trovi il percorso completo, i passaggi dettagliati, i costi aggiornati e un pacchetto di script pronti, testati su Windows.

Mappa del percorso: da zero al tuo primo agente

Un lettore mi ha chiesto dove trovare una spiegazione chiara e progressiva su come funzionano le API, come creare automazioni e come strutturare un agente AI semplice, comprendendo a fondo ogni riga di codice senza limitarsi al copia-incolla. Questo percorso è suddiviso in tre fasi sequenziali:

Le fasi 2 e 3 sono raccolte nella guida Agenti AI da zero. Per i concetti teorici di supporto: LLM: come funziona un modello linguistico, MCP, RAG e fine-tuning.

Che cos’è un’API AI

Un’API (Application Programming Interface) è un canale standardizzato che consente a un software di richiedere un servizio a un altro. Nel contesto dell’intelligenza artificiale, il tuo script invia via web una richiesta specificando modello, messaggi e parametri; il server del provider elabora il testo e restituisce il risultato generato. Non serve un’interfaccia grafica di chat, non resta cronologia visiva e non è richiesto un abbonamento fisso: paghi solo in base ai token elaborati in ingresso e in uscita.

Ecco una richiesta reale inviata il 4 ottobre 2026 tramite terminale su Windows (il prompt è stato testato originariamente in polacco con la richiesta “Scrivi una frase su Cracovia”):

#!/usr/bin/env bash
# Prima richiesta tramite curl (Git Bash, Linux, macOS). Configura prima: export OPENROUTER_API_KEY=sk-or-v1-...
curl -s https://openrouter.ai/api/v1/chat/completions \
  -H "Authorization: Bearer $OPENROUTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-6-luna",
    "messages": [{"role": "user", "content": "Napisz jedno zdanie o Krakowie."}]
  }'

Il modello GPT-6 Luna ha risposto con una frase su Cracovia, consumando 16 token in input e 36 in output; OpenRouter ha addebitato circa 0,0000175 EUR (0,0000196 USD). L’analisi completa di payload, risposte, JSON e gestione degli errori (401, 429, 500) è disponibile nella guida Che cos’è un’API: spiegazione pratica con l’AI.

Alcune applicazioni pratiche tipiche:

• riassumere e-mail, note e documenti in background senza ricorrere a copia-incolla;
• estrarre dati da fatture, curriculum o annunci riversandoli direttamente in un foglio di calcolo;
• integrare un assistente virtuale su un sito web o su una piattaforma di messaggistica;
• classificare ticket di supporto e recensioni dei clienti;
• avviare routine notturne programmate per generare report pronti al mattino;
• alimentare agenti autonomi capaci di utilizzare tool esterni (la fase 3 del percorso).

Come iniziare: la sequenza pratica

1. Comprendi il flusso richiesta-risposta. Dedica 15 minuti all’articolo Che cos’è un’API ed esegui la tua prima chiamata curl.
2. Crea un account e genera una chiave. Per iniziare consiglio OpenRouter (un’unica chiave per centinaia di modelli) oppure Google AI Studio (piano gratuito, senza carta di credito iniziale). I dettagli operativi e le norme di sicurezza sono in Chiave API: come ottenerla e proteggerla.
3. Imposta un limite di spesa sulla chiave. Un tetto di circa 1,80-4,50 EUR (2-5 USD) al mese è più che sufficiente per fare pratica ed è l’unica vera tutela in caso di fuga accidentale della chiave.
4. Installa Python ed esegui la prima chiamata. Ambiente virtuale, libreria openai, streaming dei token e gestione degli errori con retry: trovi tutto in Prima richiesta API AI in Python (con variante per Node.js).
5. Calcola i consumi effettivi. Consulta la guida su Token AI e calcolo dei costi API.
6. Approfondisci i parametri. System prompt, temperatura, finestra di contesto e limite max_tokens con prove pratiche: Parametri API spiegati in modo semplice.
7. Richiedi output strutturato. Scopri come forzare risposte affidabili in Structured output: vincolare l’AI al formato JSON, passaggio essenziale per qualsiasi automazione.
8. Scegli il provider definitivo. Consulta il nostro confronto in OpenAI, Claude o Gemini API e la guida completa a OpenRouter.

Panoramica dei modelli e dei provider

Ogni azienda propone una gamma che spazia da modelli veloci ed economici a varianti complesse e costose. Per iniziare è sufficiente conoscerne uno per fascia:

Le specificità dei singoli fornitori sono trattate in approfondimenti dedicati: Google AI Studio, DeepSeek, Mistral, Kimi, Grok API e Agents API di OpenAI.

Costi delle API

La tariffazione si basa sui milioni di token processati, con tariffe distinte per input e output. Prezzi rilevati il 4 ottobre 2026, espressi in USD con stima equivalente in EUR (tasso BCE 12/10/2026, 1 EUR = 1,1181 USD), al netto delle imposte:

* Scenario stimato: riassunto di e-mail da 800 token di input e 150 token di output, ripetuto 100 volte al giorno per 30 giorni. Per la tabella completa su 20 modelli e un calcolatore interattivo, consulta la guida su Token AI: cosa sono e quanto costano. Aspetti chiave da ricordare: i modelli dotati di ragionamento computano i token di “pensiero” all’interno dell’output (Gemini 3.8 Flash ha consumato nel nostro test 390 token di riflessione interna per generare due frasi finali) e i testi nelle lingue con caratteri speciali o morfologia complessa tendono a occupare più token rispetto all’inglese.

Efficienza di tokenizzazione nelle lingue diverse dall’inglese

I modelli moderni gestiscono correttamente numerose lingue europee. In un test comparativo su sei modelli chiamati con lo stesso prompt, tutti hanno generato risposte grammaticalmente accurate, mostrando differenze principalmente nello stile e nel rispetto dei vincoli formali. Tuttavia, l’efficienza della tokenizzazione varia sensibilmente: abbiamo inviato lo stesso paragrafo a sette modelli, confrontando la resa in polacco rispetto all’inglese:

Indicazione pratica: quando elabori testi non inglesi, confronta le soluzioni esaminando il costo reale per chiamata (campo usage.cost) piuttosto che il semplice prezzo di listino per milione di token. Claude Sonnet 5.5 e GPT-6.1 Sol condividono lo stesso listino teorico, ma nel nostro test il testo in lingua non inglese ha richiesto su Claude circa 1,7 volte più token. Metodologia e codice di misurazione sono illustrati nell’articolo sui token.

Test pratico: pacchetto iniziale per le API

Ogni frammento di codice citato in questo percorso è stato eseguito in un ambiente reale, riportando i dati effettivi. Configurazione utilizzata: Windows 11 Pro, Python 3.13.15 (librerie openai 3.24.0, pydantic 2.13.5, tiktoken 0.14.0), Node.js 26.10 (openai 7.27.0), curl 8.22. Accesso ai modelli tramite OpenRouter. Gli script sono organizzati in un archivio completo con file di configurazione .env.example (privo di chiavi):

Scarica gli script pronti: pacchetto iniziale per le API.zip

Contenuto dell’archivio:

• 01-03: prima richiesta con contatore dei costi, streaming dei dati, gestione degli errori con retry e un server simulato che restituisce errore 429 per collaudo a costo zero;
• 04: test con variazioni di temperatura a 0, 0,7 e 1,2, con evidenza dei casi in cui GPT-6 non applica modifiche;
• 05: structured output con estrazione dati da fatture tramite schema Pydantic e categorizzazione feedback;
• 06: scomposizione in token e misurazione dell’overhead linguistico su 7 modelli;
• 07: configurazione del system prompt e gestione del troncamento via max_tokens;
• 08: elenco dei modelli gratuiti disponibili tramite OpenRouter;
• 09: invio dello stesso quesito a 6 modelli con confronto di tempi e costi;
• 10: interrogazione dello stesso modello su provider diversi per confrontare prezzo, latenza e politiche sui dati;
• curl/, js/, dostawcy/: chiamate da riga di comando, implementazioni per Node.js ed esempi dedicati alle librerie ufficiali di OpenAI, Anthropic e Gemini.

Nota di trasparenza metodologica: gli script nella cartella dostawcy/ sono stati validati con chiavi fittizie per confermare la sintassi e la risposta dell’endpoint di autenticazione. Tutti gli altri script hanno interrogato direttamente i modelli di produzione. La spesa complessiva per l’intero set di test è stata di circa 0,04 EUR (0,05 USD).

Osservazioni emerse dalle prove:

• impostando la temperatura a 0 il modello ha restituito per tre volte una risposta identica al singolo carattere; con temperatura a 1,2 ha generato neologismi arbitrari e interruzioni di riga irregolari;
• la medesima richiesta inviata a sei modelli ha generato costi variabili tra 0,000018 EUR (0,00002 USD) e 0,00280 EUR (0,00313 USD), con uno scarto di circa 150 volte a parità di utilità pratica;
• il modello open source gpt-oss-120b testato su quattro endpoint differenti ha registrato tempi di risposta tra 0,4 e 6,2 secondi, con variazioni di costo fino a 5,6 volte;
• una richiesta generica di “rispondere in JSON” senza schema validato ha restituito un blocco Markdown contenente JSON, provocando un errore di parsing con la funzione json.loads.

API, chat web, modelli locali o strumenti no-code

Un’analisi comparativa tra l’esecuzione di un modello sulla propria GPU e l’utilizzo di API cloud è illustrata nell’articolo Modello locale o API a confronto. Le piattaforme no-code, trattate nella fase 2, si appoggiano internamente alle medesime chiamate API: comprenderne i meccanismi di base resta quindi fondamentale.

A chi è rivolta questa guida

• A chi utilizza abitualmente le chat AI e desidera automatizzare processi ripetitivi senza intervenire manualmente.
• Agli sviluppatori senza esperienza specifica in ambito AI, per acquisire padronanza su token, parametri, allocazione dei costi e formati strutturati.
• A professionisti e piccole imprese, per quantificare l’impatto economico di un’integrazione prima di delegare lo sviluppo a fornitori esterni.
• A studenti e appassionati, che possono eseguire tutte le prove sfruttando i modelli accessibili gratuitamente.

Non sono richieste competenze avanzate di programmazione: è sufficiente saper eseguire comandi da terminale e adattare parametri di base. Per un approccio completamente privo di codice è consigliabile iniziare dalla guida Automazione con l’AI: da dove iniziare.

Domande frequenti

Che cos’è un’API?

Un’API è un’interfaccia software che definisce le regole di comunicazione tra due programmi: uno invia una richiesta strutturata, l’altro restituisce una risposta conforme. Con l’AI, permette di interrogare modelli linguistici direttamente dal codice anziché tramite un’interfaccia grafica.

Quanto costa usare un’API AI?

Il costo è proporzionale ai token impiegati: si parte da circa 0,089 EUR (0,10 USD) per milione di token in input con GPT-6 Luna fino a circa 44,72 EUR (50,00 USD) per milione di token in output sui modelli più avanzati come GPT-6 Astra o Claude Fable 5.1. Una singola chiamata su un modello leggero richiede in media frazioni di centesimo. Puoi effettuare simulazioni dettagliate nel nostro calcolatore.

Esistono opzioni gratuite per le API AI?

Sì. Google offre una soglia gratuita per i modelli Gemini Flash, mentre OpenRouter include 17 modelli utilizzabili senza costi entro un limite di 50 richieste giornaliere. OpenAI richiede un credito prepagato, mentre Anthropic accredita talvolta un piccolo importo promozionale alla registrazione.

Come si ottiene una chiave API?

Basta registrarsi sulla piattaforma del provider prescelto (platform.openai.com, platform.claude.com, aistudio.google.com oppure openrouter.ai) e creare una chiave nella sezione impostazioni. La chiave viene visualizzata integralmente soltanto al momento della generazione. Per le buone pratiche di custodia, consulta la guida alla chiave API.

L’abbonamento a ChatGPT Plus include l’accesso alle API?

No. L’abbonamento consumer a ChatGPT Plus è separato dalla piattaforma sviluppatori di OpenAI, che adotta una fatturazione autonoma a consumo; la stessa distinzione si applica ai piani di Claude e Gemini.

Che cos’è OpenRouter?

È un servizio aggregatore che fornisce l’accesso a oltre 460 modelli tramite una sola interfaccia e un’unica chiave API, applicando i prezzi ufficiali dei singoli provider con una commissione del 5,5% sulle ricariche. Tutti i test di questo articolo sono stati condotti tramite questa piattaforma; per i dettagli consulta la guida a OpenRouter.

È obbligatorio saper programmare per iniziare?

No, per le verifiche preliminari è sufficiente eseguire comandi curl da riga di comando o avviare gli script forniti. Per realizzare automazioni stabili nel tempo è comunque utile acquisire nozioni base di Python o impiegare una piattaforma di automazione no-code.

Quale linguaggio conviene scegliere?

Python garantisce la documentazione più ampia e il supporto immediato tramite gli SDK ufficiali di ogni fornitore. JavaScript (Node.js) rappresenta l’alternativa naturale se intendi realizzare applicazioni web o bot interattivi.

Fonti e riferimenti di verifica

Specifiche tecniche e prezzi sono stati verificati il 4 ottobre 2026. Gli script di prova sono stati eseguiti nella stessa data su Windows 11 tramite OpenRouter.

• OpenAI - Listino API
• Anthropic - Listino API Claude
• Google - Listino Gemini API
• DeepSeek - Listino ufficiale
• xAI - Modelli e tariffe
• OpenRouter - Documentazione rapida
• OpenRouter - Catalogo endpoint modelli
• openai-python - Repository libreria

// continua a leggereOpenAI API: come ottenere la chiave, costi e prima chiamataGuideCos’è un’API? Spiegazione con l’AI e prima chiamata curlGuideCloudflare AI Gateway: come funziona e costi dell’Auto RouterStrumenti IA

Kinetyra