當透過 http://localhost:11434 在本地存取 Ollama 的 API 時，不需要身分驗證。

以下操作需要身分驗證：

• 透過 ollama.com 執行雲端模型
• 發佈模型
• 下載私有模型

Ollama 支持兩種身分驗證方式：

• 登入：從您的本地安裝版進行登入，執行指令時 Ollama 將自動處理與 ollama.com 的請求驗證
• API keys：用於程式存取 ollama.com API 的 API keys

登入

若要從您的本地 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 keys

若要直接存取位於 https://ollama.com/api 的 ollama.com API，則需要透過 API keys 進行身分驗證。

首先，建立一個 API key，然後設定 OLLAMA_API_KEY 環境變數：

export OLLAMA_API_KEY=your_api_key

然後在 Authorization 標頭中使用該 API key：

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 keys 不會過期，但您可以在 API keys 設定 中隨時撤銷它們。