OpenAI API: come ottenere la chiave, costi e prima chiamata

👁 113 letture

L’OpenAI API key, ovvero la chiave per accedere all’interfaccia di programmazione di OpenAI, e una cosa ben diversa dall’abbonamento a ChatGPT: per le API paghi a consumo in base ai token invece di una tariffa fissa mensile, e puoi integrare i modelli direttamente nei tuoi script, fogli di calcolo o applicazioni. La chiave si genera in pochi minuti su platform.openai.com, e una prima chiamata in Python richiede appena cinque righe di codice. Vediamo come configurare l’account, come ricaricarlo, quanto costano i token, come effettuare la prima chiamata ed evitare di esporre la chiave.

Cos’e l’OpenAI API e in cosa differisce da ChatGPT

L’API e un endpoint all’indirizzo api.openai.com a cui un programma invia testo (oppure immagini o audio) e riceve come risposta l’output elaborato dal modello. Non ci sono un’interfaccia grafica, una cronologia predefinita o una “memoria”: tutto cio che il modello deve considerare va specificato all’interno della richiesta. Il conteggio avviene in token: circa 750 parole in inglese equivalgono a 1.000 token, mentre in altre lingue come l’italiano lo stesso numero di parole richiede generalmente piu token.

Gli abbonamenti ChatGPT (Go, Plus, Pro) si acquistano su chatgpt.com e coprono esclusivamente l’utilizzo dell’interfaccia web o app. La piattaforma per sviluppatori si trova invece su platform.openai.com, con un saldo dedicato, fatture proprie e limiti di utilizzo autonomi. Puoi utilizzare lo stesso indirizzo email per entrambi i servizi, ma i crediti e le spese non sono condivisi. Per valutare quando conviene passare a una formula a consumo, abbiamo analizzato la soglia di convenienza nel nostro articolo su abbonamento o API, mentre i dettagli sulle formule consumer sono disponibili nella guida ai prezzi di ChatGPT.

Come ottenere la chiave API passo dopo passo

• Account: visita platform.openai.com ed effettua l’accesso con il tuo account OpenAI (lo stesso di ChatGPT o uno dedicato). La piattaforma creera un’organizzazione in cui gestire progetti, chiavi e fatturazione.
• Dati di fatturazione: vai su Settings, Organization, Billing, Billing details. Se acquisti per conto di un’azienda, seleziona “Business” e inserisci la partita IVA comunitaria prima di effettuare qualsiasi ricarica; le fatture gia emesse non possono essere modificate retroattivamente.
• Ricarica: il pagamento avviene con carta, in modalita prepagata. Il listino ufficiale di OpenAI non prevede crediti gratuiti iniziali; un primo versamento di 5 USD porta l’account al Tier 1. Ti consigliamo di impostare subito una soglia di ricarica automatica oppure di disattivarla del tutto per evitare addebiti imprevisti.
• Chiave segreta: nella sezione platform.openai.com/api-keys, clicca su “Create new secret key”, preferibilmente associandola a uno specifico progetto e limitandone i permessi. La chiave inizia con sk- e verra mostrata per intero solo una volta: copiala immediatamente nel tuo password manager.

I limiti di spesa e di frequenza dipendono dal livello (Tier) dell’account. In base alla documentazione ufficiale sui limiti di OpenAI:

Con il salire di livello aumentano di conseguenza anche le richieste e i token utilizzabili al minuto, parametrizzati per ogni singolo modello.

Prezzi dei modelli OpenAI API

Tariffe tratte dalla pagina ufficiale dei prezzi di OpenAI, espresse per milione di token, IVA esclusa. La voce “Cache” fa riferimento ai token di input ripetuti da una chiamata precedente (ad esempio un prompt di sistema voluminoso), fatturati a un costo ridotto.

Tre esempi pratici di costo calcolati su queste tariffe:

• Chatbot di assistenza clienti: 10.000 conversazioni al mese, ciascuna con circa 1.500 token in ingresso (incluse le istruzioni di sistema) e 300 token in uscita. Con Luna: 15 milioni × 0,10 USD + 3 milioni × 0,50 USD = 3 USD complessivi. Con Sol il totale sale a 60 USD.
• Sintesi di documenti: 500 file di circa 10.000 token ciascuno, con un riassunto finale da 500 token. Con Sol si spendono 12,50 USD, che scendono a 6,25 USD sfruttando la Batch API.
• Assistente di analisi su larga scala con Astra: 6.000 richieste mensili con 8.000 token in ingresso (il 70 percento coperto da cache) e 1.500 in uscita. Il costo di input e di circa 178 USD e l’output vale 450 USD, per un totale di circa 628 USD. Questo dimostra come la scelta del modello incida sul budget molto piu del volume grezzo delle chiamate.

Se desideri confrontare queste tariffe con modelli alternativi accessibili tramite un’unica chiave, consulta la nostra guida ai costi di OpenRouter; per approfondire la gamma dei modelli consulta l’analisi sui prezzi di GPT-6 Sol e Luna.

Come effettuare la prima chiamata

Memorizza sempre la chiave all’interno di una variabile d’ambiente anziche inserirla in chiaro nel codice: usa export OPENAI_API_KEY="sk-..." su macOS e Linux, oppure setx OPENAI_API_KEY "sk-..." su Windows. La libreria ufficiale la rilevera in autonomia. Ecco un esempio basato sulla guida rapida ufficiale (Responses API):

pip install openai

from openai import OpenAI
client = OpenAI()
response = client.responses.create(
    model="gpt-6-luna",
    input="Streść w dwóch zdaniach, czym jest token."
)
print(response.output_text)

Abbiamo eseguito il test con un prompt in polacco: Streść w dwóch zdaniach, czym jest token. (“Riassumi in due frasi che cos’e un token”).

Puoi ottenere lo stesso risultato tramite curl inviando una richiesta POST all’indirizzo https://api.openai.com/v1/responses con l’header Authorization: Bearer $OPENAI_API_KEY e un payload JSON contenente i campi model e input. L’interfaccia Responses API gestisce in modo integrato strumenti esterni (ricerca, file, funzioni) e mantiene lo stato della sessione lato server. I codici di errore tipici da gestire fin da subito sono: 401 (chiave non valida), 429 (limite di chiamate superato o credito esaurito; la documentazione consiglia di implementare tentativi ripetuti con attesa esponenziale e jitter casuale leggendo l’header Retry-After), e gli errori 5xx per disservizi temporanei del server.

Sicurezza e buone pratiche per la chiave API

• Non pubblicare mai la chiave nel codice sorgente su repository pubblici ne all’interno di applicazioni client che girano nel browser: effettua sempre le chiamate passando da un backend proprietario. I bot automatizzati scansionano GitHub in pochi minuti alla ricerca di chiavi esposte.
• Crea chiavi distinte per ciascun progetto, assegnando loro permessi minimi, e revoca immediatamente quelle inutilizzate.
• Dalla sezione Billing, alla voce Limits, imposta un tetto massimo mensile di spesa e una soglia di avviso: un loop imprevisto nel codice puo prosciugare l’intero saldo in poche ore.
• Se una chiave viene compromessa: eliminala all’istante su platform.openai.com/api-keys (smettera di funzionare subito), controlla i consumi nella scheda Usage, rigenera un nuovo token e rimuovi ogni traccia dalla cronologia dei commit. Come evidenziato nell’approfondimento sui leak delle credenziali AI, questo tipo di incidente coinvolge fino al 98 percento delle organizzazioni.

Domande frequenti

OpenAI API offre crediti gratuiti di prova?

Il listino prezzi ufficiale non indica crediti omaggio all’iscrizione. Per effettuare chiamate e necessario aggiungere un metodo di pagamento ed effettuare una prima ricarica: anche un deposito minimo di 5 USD e sufficiente per eseguire migliaia di richieste con il modello Luna.

I dati inviati via API vengono usati per l’addestramento?

No. Secondo i termini di servizio di OpenAI, i dati transitati tramite API dal 1 marzo 2023 non vengono impiegati per addestrare i modelli, a meno di un consenso esplicito dell’utente. I log per il rilevamento di eventuali abusi vengono conservati fino a 30 giorni; per i clienti idonei e possibile richiedere la conservazione zero, ed e disponibile un endpoint dedicato eu.api.openai.com per l’elaborazione all’interno dello Spazio Economico Europeo.

Come funziona la fatturazione con partita IVA per le aziende europee?

Per le aziende con sede nell’Unione Europea, il servizio viene fatturato dall’entita OpenAI Ireland Ltd. Inserendo la propria partita IVA registrata al VIES (con prefisso paese) nei dettagli di fatturazione, la fattura verra emessa senza IVA in regime di reverse charge (inversione contabile intra-UE). Se la partita IVA non viene registrata, OpenAI applichera l’IVA locale irlandese al 23 percento. Per approfondire gli aspetti contabili dei servizi esteri, consulta il nostro articolo sui pagamenti per i tool di intelligenza artificiale.

// continua a leggereDecision model vs LLM: differenze, costi e compitiGuideGPT-6.1 Sol conviene? Analisi costi-beneficiGuideClaude Sonnet 5.5 conviene? Analisi costi-beneficiGuide

Kinetyra