Non è richiesta alcuna autenticazione quando si accede all'API di Ollama in locale tramite http://localhost:11434.
L'autenticazione è richiesta per le seguenti operazioni:
- Esecuzione di modelli cloud tramite ollama.com
- Pubblicazione di modelli
- Download di modelli privati
Ollama supporta due metodi di autenticazione:
- Accesso: accedi dalla tua installazione locale, e Ollama si occuperà automaticamente di autenticare le richieste a ollama.com quando esegui i comandi
- Chiavi API: chiavi API per l'accesso programmatico all'API di ollama.com
Accesso
Per accedere a ollama.com dalla tua installazione locale di Ollama, esegui:
ollama signinUna volta effettuato l'accesso, Ollama autenticherà automaticamente i comandi secondo necessità:
ollama run gpt-oss:120b-cloudAllo stesso modo, quando accedi a un endpoint API locale che richiede l'accesso al cloud, Ollama autenticherà automaticamente la richiesta:
shell
curl http://localhost:11434/api/generate -d '{
"model": "gpt-oss:120b-cloud",
"prompt": "Why is the sky blue?"
}'Chiavi API
Per l'accesso diretto all'API di ollama.com servita all'indirizzo https://ollama.com/api, è richiesta l'autenticazione tramite chiavi API.
Per prima cosa, crea una chiave API, quindi imposta la variabile d'ambiente OLLAMA_API_KEY:
shell
export OLLAMA_API_KEY=your_api_keyQuindi utilizza la chiave API nell'intestazione Authorization:
shell
curl https://ollama.com/api/generate \
-H "Authorization: Bearer $OLLAMA_API_KEY" \
-d '{
"model": "gpt-oss:120b",
"prompt": "Why is the sky blue?",
"stream": false
}'Le chiavi API non scadono attualmente, tuttavia puoi revocarle in qualsiasi momento nelle tue impostazioni delle chiavi API.