跳过至正文
通过 https://: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 https://:11434/api/generate -d '{
  "model": "gpt-oss:120b-cloud",
  "prompt": "Why is the sky blue?"
}'

API 密钥

要直接访问位于 https://ollama.ac.cn/api 的 ollama.com API,需要通过 API 密钥进行身份验证。 首先,创建一个 API 密钥,然后设置 OLLAMA_API_KEY 环境变量:
export OLLAMA_API_KEY=your_api_key
然后在 Authorization 请求头中使用该 API 密钥
curl https://ollama.ac.cn/api/generate \
  -H "Authorization: Bearer $OLLAMA_API_KEY" \
  -d '{
    "model": "gpt-oss:120b",
    "prompt": "Why is the sky blue?",
    "stream": false
  }'
API 密钥目前不会过期,但您可以随时在 API 密钥设置 中将其撤销。