Nenhuma autenticação é necessária ao acessar a API do Ollama localmente via http://localhost:11434.
A autenticação é necessária para os seguintes casos:
- Executar modelos de nuvem via ollama.com
- Publicar modelos
- Baixar modelos privados
Ollama suporta dois métodos de autenticação:
- Entrar: faça login a partir da sua instalação local do Ollama, e o Ollama irá gerenciar automaticamente a autenticação de solicitações para o ollama.com ao executar comandos
- Chaves de API: chaves de API para acesso programático à API do ollama.com
Entrar
Para fazer login no ollama.com a partir da sua instalação local do Ollama, execute:
ollama signinDepois de fazer login, o Ollama irá autenticar automaticamente os comandos conforme necessário:
ollama run gpt-oss:120b-cloudDa mesma forma, ao acessar um endpoint de API local que requer acesso à nuvem, o Ollama irá autenticar automaticamente a solicitação:
shell
curl http://localhost:11434/api/generate -d '{
"model": "gpt-oss:120b-cloud",
"prompt": "Why is the sky blue?"
}'Chaves de API
Para acesso direto à API do ollama.com disponibilizada em https://ollama.com/api, a autenticação via chaves de API é necessária.
Primeiro, crie uma chave de API, depois defina a variável de ambiente OLLAMA_API_KEY:
shell
export OLLAMA_API_KEY=your_api_keyDepois, use a chave de API no cabeçalho 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
}'As chaves de API não expiram atualmente, porém você pode revogá-las a qualquer momento nas configurações de chaves de API.