Pura LLM Docs
Due percorsi, una scelta chiara
Inizia dal prodotto che vuoi usare: API a consumo con wallet oppure SDK collegati all’abbonamento dell’utente. Credenziali, endpoint e modalità di consumo sono distinti.
A consumo
La tua applicazione chiama i modelli con la tua chiave API e usa il tuo wallet. Scegli tu il modello a ogni richiesta.
Inizia con le API a consumo →SDK in abbonamento
Ogni utente collega il proprio account con Connect. La tua app usa i servizi e i limiti del suo abbonamento tramite OAuth.
Inizia con gli SDK in abbonamento →Confronta i due percorsi
| Aspetto | A consumo | SDK in abbonamento |
|---|---|---|
| Pagamento | Wallet: paghi il consumo delle richieste. | Abbonamento: usi i servizi entro i limiti del piano. |
| Credenziali | Chiave API del tuo account, custodita sul server. | Token OAuth dell’utente, dopo il consenso a un’app registrata. |
| Base URL | https://llm.puradigital.it/v1 | https://ai.puradigital.it/v1 |
| Chat | /chat/completions | /integrations/inference/chat/completions |
| Modello | Invii model con un ID del catalogo disponibile. | Ometti model: Pura configura il modello per servizio. |
| Librerie | HTTP, SDK OpenAI o altri client compatibili. | @pura-ai/sdk, pura-llm-sdk; @pura-ai/react per la UI. |
| Monitoraggio | Saldo wallet, costi e limiti delle chiavi API. | usage(): percentuali mensili e settimanali e date di reset. |
| Limite esaurito | Controlla saldo e limiti della chiave. | Controlla il piano e i reset. Nessun fallback sul wallet. |
SDK OpenAI e SDK Pura hanno ruoli diversi
Il client OpenAI chiama le API a consumo con una chiave API Pura. Gli SDK @pura-ai/sdk e pura-llm-sdk gestiscono Connect, OAuth e inferenza in abbonamento. Installare una libreria non attiva un piano e non rende intercambiabili le credenziali.
Privacy e assistenza
Consulta le condizioni di trattamento e le informazioni sui provider per il servizio e il modello utilizzati.