API compatibile con OpenAI

Il formato di chat di OpenAI è diventato uno standard di fatto. Una richiesta è un corpo JSON che indica un modello e un elenco di messaggi, ciascuno con un ruolo come system, user o assistant. Il ruolo system o developer porta le istruzioni permanenti, mentre user e assistant si alternano nel corso della conversazione. La risposta torna come elenco di scelte, o come flusso di eventi inviati dal server che termina con un segnale di fine. L’uso di strumenti segue lo stesso schema: descrivi funzioni con uno schema JSON, il modello risponde con una chiamata a uno strumento, tu esegui la funzione e rimandi il risultato. Anche gli altri endpoint, per embedding o immagini, seguono le forme di OpenAI. Esistono librerie ufficiali per Python e JavaScript, e funziona anche un semplice comando curl.

Compatibilità significa che queste forme coincidono, ed è per questo che gli SDK ufficiali e molti agenti di programmazione permettono di impostare un URL di base personalizzato. Non significa che tutto coincida. I nomi dei modelli sono quelli del fornitore, i parametri supportati possono differire, limiti e prezzi li fissa ciascun servizio e i codici di errore possono variare nei dettagli. Un modello deve anche avere la capacità giusta: chiamare una funzione su un modello che non usa strumenti restituisce un errore, quindi controlla cosa supporta ciascun modello prima di fidartene. Provare costa poco: invia una breve richiesta, confronta il JSON ricevuto con ciò che la tua libreria si aspetta e leggi il corpo dell’errore, che di solito nomina il campo sbagliato.

Anthropic usa un formato diverso, chiamato Messages, con blocchi propri per l’uso di strumenti e per gli eventi di streaming. Alcuni fornitori offrono entrambi i formati, così gli strumenti pensati per una famiglia funzionano senza modifiche al codice. Il vantaggio pratico è la portabilità: puoi confrontare modelli o lasciare un fornitore senza riscrivere l’applicazione, e il costo del cambio si riduce a una modifica di configurazione. Anche i tentativi ripetuti meritano cura: un timeout durante una risposta lunga può essere stato comunque fatturato, quindi registra gli identificatori delle richieste.

L’API di NeverNo segue entrambi. Imposta l’URL di base su https://neverno.ai/api/v1 e passa una chiave che inizia con nn_live_ come token bearer, o in un’intestazione x-api-key come la inviano gli SDK di Anthropic. POST /chat/completions gestisce la chat in un colpo solo o in streaming, con chiamata di funzioni, uscita JSON e visione, GET /models elenca ogni modello con le sue capacità e il prezzo in crediti, e POST /messages parla il formato di Anthropic per Claude Code. Parametri come temperature, top_p, stop e seed vengono passati ai modelli che li accettano. Ci sono anche embedding, immagini e POST /image/upscale.

L’uso si paga da un saldo API proprio, dove 1 credito vale 0,01 $, separato dai crediti di un piano. Ogni account ha un numero di richieste ogni 24 ore scorrevoli, oltre il quale le chiamate ricevono un 429. NeverNo non registra né conserva prompt, messaggi, risposte o immagini inviati tramite l’API, solo ciò che serve alla fatturazione. GPT-6.1 Terra, il modello rapido di OpenAI, si raggiunge in modo anonimizzato e permette di spegnere o alzare il ragionamento; la pagina sull’alternativa a ChatGPT spiega perché molti passano a NeverNo per questa scelta di modelli.