A consumo: API e wallet
Questo percorso è adatto quando la tua applicazione usa la chiave API del tuo account e vuoi scegliere il modello per ogni richiesta. I consumi vengono addebitati al tuo wallet.
Dalla console alla prima richiesta
Prepara account e wallet
Accedi alla console A consumo e verifica il saldo del wallet prima di inviare richieste. Il pagamento di un abbonamento SDK non ricarica il wallet.
Apri fatturazione →Crea una chiave API
Genera una chiave per la tua applicazione e conservala sul backend. Non inserire la chiave nel browser o in un’app distribuita agli utenti.
Autenticazione con API key →Scegli un modello disponibile
Leggi il catalogo del gateway con la stessa chiave che userai per l’inferenza. Usa un ID restituito da /models e controlla prezzi, disponibilità e limiti applicabili.
Catalogo dei modelli →Invia la richiesta e controlla i consumi
Chiama /chat/completions con il campo model. Monitora costi e limiti nella console A consumo; usa stream: true per le risposte SSE quando supportate.
Quickstart HTTP, Python e Node →
Verifica endpoint e credenziali
Imposta PURA_API_KEY tramite il tuo secret manager. Questa chiamata legge i modelli disponibili; non genera un’inferenza.
curl https://llm.puradigital.it/v1/models \
-H "Authorization: Bearer $PURA_API_KEY"Vuoi usare il client OpenAI?
Puoi usare il client OpenAI configurando la base URL del gateway e una chiave API Pura. Il costo resta a consumo sul wallet Pura. Non servono Connect, client_id o token OAuth.
Configura il client OpenAI →Se la richiesta non riesce
- 401: verifica la chiave API e la base URL del gateway. Un token OAuth dell’abbonamento non sostituisce la chiave.
- 402: controlla il credito disponibile e il dettaglio dell’errore. Un abbonamento attivo non aggiunge credito al wallet.
- 429: controlla i limiti applicabili e il dettaglio della risposta prima di riprovare.
Dopo un timeout con esito incerto, verifica i log prima di ripetere un’inferenza: un retry può generare un nuovo consumo.