API GPT: usare i modelli GPT-6 nel tuo codice

Gli sviluppatori accedono ai modelli GPT tramite le API di OpenAI o attraverso router come OpenRouter. Questa guida mostra la prima richiesta, gli ID dei modelli, le opzioni di reasoning e i costi di ciascuno.

6 min di letturaAggiornato

Due modi per chiamare GPT dal tuo codice

Se vuoi integrare GPT nella tua app, in uno script o in un foglio di calcolo, ti serve l'accesso API. Ci sono due strade principali:

  • L'API di OpenAI su https://api.openai.com/v1. Ti registri sulla piattaforma di OpenAI, imposti la fatturazione, crei una chiave e chiami direttamente modelli come gpt-6-luna o gpt-6.1-terra.
  • OpenRouter su https://openrouter.ai/api/v1. Una sola chiave ti dà accesso a GPT insieme ai modelli di altre aziende, con lo stesso formato di richiesta per tutti. Gli ID dei modelli GPT hanno il prefisso openai/, ad esempio openai/gpt-6-luna.

Entrambe fatturano per token, i piccoli frammenti di testo che il modello legge e scrive. L'input (il tuo prompt) e l'output (la risposta) hanno prezzi separati, e l'output costa sempre di più. Anche i token di ragionamento, il "pensiero" nascosto che il modello elabora prima di rispondere, vengono fatturati come output.

Una breve nota prima di iniziare: GPT.me non offre un'API pubblica. La nostra chat è un sito web pensato per le persone. Per il codice, usa una delle due opzioni sopra.

Prezzi attuali di GPT

Prezzi per milione di token per gli attuali modelli GPT-6, come indicati su OpenRouter; l'API di OpenAI prevede gli stessi prezzi base.

ModelloID API (OpenAI)InputInput in cacheOutput
GPT-6 Lunagpt-6-luna0,10 $0,01 $0,50 $
GPT-6.1 Terragpt-6.1-terra1 $0,05 $5 $
GPT-6 Solgpt-6-sol2 $0,20 $10 $
GPT-6.1 Solgpt-6.1-sol2 $0,10 $10 $
GPT-6 Astragpt-6-astra10 $1 $50 $

Prezzi di listino OpenRouter, nov 2026. Tutti e cinque i modelli accettano testo e immagini, restituiscono testo e hanno una finestra di contesto di 1.050.000 token con un massimo di 128.000 token di output. Quando un singolo prompt supera i 272.000 token, il listino di OpenRouter raddoppia il prezzo di input e aumenta di metà quello di output per quella richiesta. OpenRouter elenca anche varianti "pro" di ogni modello, che eseguono lo stesso modello in una modalità che consuma molti più token di ragionamento.

Chiamare OpenAI direttamente

OpenAI offre due endpoint per il testo: la più recente Responses API, usata ovunque nella documentazione di GPT-6, e il vecchio endpoint Chat Completions, che funziona ancora per le chat semplici. Crea una chiave sulla piattaforma, salvala in una variabile d'ambiente chiamata OPENAI_API_KEY, quindi invia una richiesta. Con curl:

curl https://api.openai.com/v1/responses \
  -H "Authorization: Bearer $OPENAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-6-luna",
    "reasoning": { "effort": "none" },
    "input": "List three uses for a paper clip, one line each."
  }'

La risposta è in formato JSON; il testo generato si trova nell'array output. La libreria Python ufficiale lo estrae automaticamente:

from openai import OpenAI

client = OpenAI()  # reads OPENAI_API_KEY

result = client.responses.create(
    model="gpt-6.1-terra",
    reasoning={"effort": "low"},
    input="Is 391 a prime number? Explain in two sentences.",
)
print(result.output_text)

Installala con pip install openai. La stessa libreria è disponibile anche per JavaScript e diversi altri linguaggi.

Chiamare GPT tramite OpenRouter

OpenRouter usa il formato Chat Completions, quindi la maggior parte del codice compatibile con OpenAI funziona cambiando solo l'indirizzo di base, la chiave e l'ID del modello. La sua guida introduttiva copre tutti i dettagli. Ecco un esempio in JavaScript puro senza librerie esterne:

const OPENROUTER_URL = "https://openrouter.ai/api/v1/chat/completions";

const payload = {
  model: "openai/gpt-6-luna",
  max_tokens: 800,
  reasoning: { effort: "low" },
  messages: [
    { role: "system", content: "Answer briefly and plainly." },
    { role: "user", content: "What is the difference between RAM and storage?" },
  ],
};

const key = process.env.OPENROUTER_API_KEY;

const res = await fetch(OPENROUTER_URL, {
  method: "POST",
  body: JSON.stringify(payload),
  headers: { Authorization: `Bearer ${key}`, "Content-Type": "application/json" },
});

const body = await res.json();
const text = body.choices?.[0]?.message?.content;
console.log(text ?? body);

Eseguilo con Node 18 o successivo, che integra fetch nativamente, salvandolo come file .mjs per abilitare l'await al livello principale. Se non viene restituito testo, lo script stampa l'intera risposta: OpenRouter include un campo error con un messaggio chiaro, ad esempio se la chiave è errata o il credito è esaurito.

Le pagine dei modelli su OpenRouter, come GPT-6 Luna e GPT-6.1 Terra, mostrano prezzi attuali, provider e parametri supportati.

Impostazioni che creano confusione

  • Reasoning effort. GPT-6 Luna, GPT-6 Sol e GPT-6.1 Terra accettano none, low, medium, high, xhigh e max, con impostazione predefinita su medium su OpenRouter. GPT-6.1 Sol e GPT-6 Astra ragionano sempre e non possono essere impostati su none. Nella Responses API il campo è reasoning.effort; in Chat Completions è reasoning_effort.
  • Temperatura. La guida di OpenAI indica che temperature e top_p non sono supportati quando il ragionamento è attivo: rimuovili a meno che l'effort non sia impostato su none. Il codice più vecchio che imposta la temperatura può fallire con un errore.
  • Limite di output. Il ragionamento consuma parte del budget di token. Se imposti un valore basso di max_tokens con un effort elevato, il modello potrebbe esaurirli prima di scrivere la risposta visibile.
  • Tools. Le pagine dei modelli di OpenAI segnalano che il function calling per GPT-6.1 Terra richiede la Responses API. Se i tool si comportano in modo anomalo con Chat Completions, cambia endpoint.

Come contenere i costi

  1. Inizia con Luna. A un decimo del prezzo di Terra, gestisce benissimo riassunti, estrazione dati, classificazione e risposte brevi. Passa ai modelli superiori solo per i compiti in cui sbaglia.
  2. Mantieni basso l'effort. Ogni livello in più di reasoning effort comporta solitamente più token di output nascosti. Usa none o low per le attività semplici.
  3. Riutilizza il prefisso. L'input in cache costa un decimo o meno rispetto all'input normale. Metti le istruzioni lunghe e invariate all'inizio di ogni prompt per sfruttare la cache nelle richieste ripetute.
  4. Resta sotto i 272.000 token per prompt quando puoi, per evitare il sovrapprezzo per il contesto lungo.
  5. Imposta un limite di spesa nella dashboard del tuo account, così un bug in un ciclo non rischierà di generare una spesa imprevista.
  6. Riduci la cronologia inviata. Ogni richiesta ripaga l'intera conversazione da capo. Mantieni solo i passaggi davvero utili al modello o sostituisci i messaggi vecchi con un breve riassunto.

Un metodo rapido per stimare i costi: un token equivale a circa tre quarti di parola in inglese. Una domanda e una risposta di poche centinaia di parole ciascuna arrivano a circa mille token totali; il prezzo per richiesta corrisponde quindi alla cifra per milione della tabella divisa per mille, più gli eventuali token di ragionamento. Controlla il campo usage in ogni risposta per verificare i numeri reali dei tuoi prompt.

Per suggerimenti di programmazione oltre all'uso dell'API, consulta la nostra guida a GPT per programmare e la pagina per sviluppatori. Per testare un prompt prima di scrivere codice, provalo prima nella nostra chat con GPT-6 Luna.

Domande frequenti

L'API di GPT è gratuita?

No. Sia OpenAI che OpenRouter fatturano per token. Un breve test con GPT-6 Luna costa una frazione di centesimo, ma serve comunque un account con un metodo di pagamento attivo.

Conviene usare direttamente OpenAI o OpenRouter?

Usa OpenAI direttamente se ti serve solo GPT e vuoi accedere subito a ogni nuova funzionalità. Scegli OpenRouter se vuoi passare facilmente tra GPT, Claude, Gemini e altri modelli con un'unica chiave e un solo conto.

Da quale modello dovrei iniziare?

GPT-6 Luna per velocità e costi contenuti, GPT-6.1 Terra per una scrittura migliore, comprensione delle immagini e ragionamenti più complessi, e GPT-6.1 Sol o GPT-6 Astra solo per coding e analisi particolarmente impegnativi.

GPT.me offre un'API?

No. GPT.me è un sito web di chat gratuito. Per l'accesso programmatico, usa l'API di OpenAI o OpenRouter.

Hai una domanda? Chiedi subito

Nessun account, nessun download. Apri la chat, scrivi cosa ti passa per la testa e la risposta inizierà a comparire in un secondo.

Inizia a chattare