Skip to content

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 signin

Una volta effettuato l'accesso, Ollama autenticherà automaticamente i comandi secondo necessità:

ollama run gpt-oss:120b-cloud

Allo 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_key

Quindi 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.