Cerca articoli della Knowledge Base

ChatGPT API: integrazione tecnica primo progetto

ChatGPT API: il tuo primo progetto in 15 minuti

L'API OpenAI permette di integrare ChatGPT (GPT-5, GPT-4o, o-series) in qualunque applicazione: web app, mobile, automazioni, chatbot. Ecco come iniziare da zero.

Step 1: creare l'account e la API key

  1. Registrati su platform.openai.com
  2. Vai in Dashboard -> API keys -> Create new secret key
  3. Copia la key (inizia per sk-...) in luogo sicuro: non sarà più visibile
  4. Carica credito iniziale (min 5$) in Billing

Step 2: scegliere il modello

  • gpt-5: massima qualità, costo alto (~10$/1M token input)
  • gpt-5-mini: bilanciato, ottimo per produzione (~1$/1M input)
  • gpt-5-nano: economico per task semplici (~0,15$/1M input)
  • gpt-4o: legacy ma stabile

Step 3: prima chiamata Python

from openai import OpenAI
client = OpenAI(api_key="sk-...")
resp = client.chat.completions.create(
    model="gpt-5-mini",
    messages=[
        {"role": "system", "content": "Sei un'assistente tecnico italiano."},
        {"role": "user", "content": "Spiega cos e un transformer in 3 righe."}
    ]
)
print(resp.choices[0].message.content)

Step 4: gestire la conversazione

L'API e' stateless: ad ogni chiamata devi inviare TUTTO lo storico messaggi. Mantieni una lista in memoria o database e accodala ogni turno.

Step 5: streaming e UX

Per UI tipo chat usa stream=True: ricevi i token man mano, evitando attese di 10-30 secondi.

Errori comuni dei principianti

  • Hardcodare la API key nel codice (mai! usa variabili d'ambiente o secret manager)
  • Non gestire rate limit (codice 429): implementa retry con exponential backoff
  • Inviare contesto inutile: ogni token costa, usa system prompt sintetici
  • Ignorare temperature: 0 per output deterministici, 0.7+ per creatività

Best practice produzione

  • Logga ogni chiamata con timestamp, modello, tokens usati
  • Imposta budget alerts in dashboard OpenAI
  • Usa structured outputs per garantire JSON valido
  • Cache prompt frequenti per ridurre costi

Linguaggi supportati

SDK ufficiali OpenAI: Python, Node.js, .NET, Java, Go. Per PHP, Ruby e altri esistono librerie community mantenute attivamente.

Vuoi integrare ChatGPT API nel tuo gestionale o sito? G Tech Group sviluppa integrazioni custom con OpenAI. Iniziamo.

Hai trovato utile quest'articolo?

Articoli Correlati