Skip to content

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 signin

Depois de fazer login, o Ollama irá autenticar automaticamente os comandos conforme necessário:

ollama run gpt-oss:120b-cloud

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

Depois, 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.