Chiamare l’API con l’SDK OpenAI
Collegate un’applicazione esistente all’API Learnya cambiando solo l’indirizzo e la chiave del client OpenAI.
10 min · 6 passi · per tutti
- Passo 1
Create una chiave
Dal vostro account, con il piano Dev o Team, create una chiave API. Limitate i suoi ambiti allo stretto necessario, fissate una quota e, se il vostro server ha un indirizzo fisso, aggiungetelo all’elenco degli IP autorizzati.
- Passo 2
Installate l’SDK
Installate la libreria ufficiale OpenAI nel vostro progetto, per esempio con pip install openai in Python. Conservate la chiave in una variabile d’ambiente, mai nel codice.
- Passo 3
Puntate il client su Learnya
Create il client con base_url="https://api.learnya.ai/v1" e la vostra chiave Learnya. Il resto del vostro codice non cambia, perché l’API è compatibile con OpenAI.
- Passo 4
Fate una prima chiamata
Chiamate client.chat.completions.create(model="flash", messages=[{"role": "user", "content": "Riassumi questo testo in tre punti."}]). Usate il modello "max" per i compiti che richiedono un ragionamento lungo.
- Passo 5
Aggiungete embedding e immagini
Le stesse chiamate dell’SDK servono per gli embedding e la generazione di immagini. I dati restano in Svizzera e non servono mai ad addestrare i modelli.
- Passo 6
Gestite quote e limiti
Prevedete un nuovo tentativo con attesa quando l’API risponde 429, segno che il limite di frequenza è stato raggiunto. Seguite il consumo di ogni chiave dal vostro account.