当通过 http://localhost:11434 本地访问 Ollama 的 API 时，不需要进行认证。

以下情况需要进行认证：

• 通过 ollama.com 运行云模型
• 发布模型
• 下载私有模型

Ollama 支持两种认证方法：

• 登录: 从您的本地安装进行登录，当运行命令时，Ollama 会自动处理对 ollama.com 的请求认证。
• API 密钥: 用于程序化访问 ollama.com API 的 API 密钥。

登录

要从您的本地 Ollama 安装登录到 ollama.com，请运行：

ollama signin

登录后，Ollama 会自动执行所需的命令认证：

ollama run gpt-oss:120b-cloud

同样，当访问需要云访问的本地 API 端点时，Ollama 会自动认证该请求：

curl http://localhost:11434/api/generate -d '{
  "model": "gpt-oss:120b-cloud",
  "prompt": "Why is the sky blue?"
}'

API 密钥

要直接访问托管在 https://ollama.com/api 上的 ollama.com API，需要通过 API 密钥进行认证。

首先，创建一个 API 密钥，然后设置 OLLAMA_API_KEY 环境变量：

export OLLAMA_API_KEY=your_api_key

然后在 Authorization 头部使用该 API 密钥：

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
  }'

API 密钥目前不会过期，但您可以在 API 密钥设置 中随时撤销它们。