OllamaのAPI認証をWindowsで確認する方法｜local・cloud・API key・signin

先に結論：認証はlocal・cloud model・直接cloud APIで分ける

Ollama公式docsでは、http://localhost:11434のlocal APIへアクセスするだけなら認証不要と説明されています。一方、cloud modelの実行、private model、公開やollama.com/apiの直接利用ではアカウントやAPI keyが関係します。まず「どこへ接続するか」と「どのmodelを実行するか」を分けて記録します。

「localだからAPI keyが必要」「cloud modelだからlocalhostを使えない」「api_key=ollamaが本物のkey」という3つの混同が起きやすい領域です。記事のコードは秘密情報を含めず、実際の送信先とmodel名を確認してから使います。

• Ollamaのlocal/cloud比較 - 推論場所とPC内処理の境界を確認する
• Ollama OpenAI互換API - base URL・model・endpointの全体像を見る
• Ollama Responses API - 認証境界をResponses実装へ適用する

Windowsのlocalhost APIを認証なしで確認する

Windows版Ollamaはインストール後にバックグラウンドで動作し、通常のAPIはhttp://localhost:11434で提供されます。local native APIの疎通確認ではAuthorization headerを足さず、まずmodel、endpoint、stream=falseを最小にします。認証不要は安全性の保証ではなく、接続範囲とネットワーク公開を別に確認してください。

1. WindowsのOllamaを起動し、PowerShellでollama lsから保存済みmodel名を確認する。
2. GET http://localhost:11434/api/tagsでAPIから見えるmodel一覧を確認する。
3. 公開可能な短いinputを使い、native /api/generateまたは/api/chatをstream=falseで呼ぶ。
4. local OpenAI互換を使う場合は、base URLをhttp://localhost:11434/v1/へ分け、model IDを確認する。
5. LANやproxyへ公開する前に、localhostだけで応答、ログ、保存先、送信経路を記録する。

ollama ls

$models = Invoke-RestMethod `
  -Uri "http://localhost:11434/api/tags"
$models.models | Select-Object name, size, digest

$payload = @{
  model = "MODEL"
  messages = @(@{ role = "user"; content = "短い疎通確認" })
  stream = $false
} | ConvertTo-Json -Depth 8

Invoke-RestMethod `
  -Uri "http://localhost:11434/api/chat" `
  -Method Post `
  -ContentType "application/json" `
  -Body $payload

local endpointの認証不要と、ネットワークへ公開してよいことは別です。OLLAMA_HOST、proxy、tunnel、ブラウザ拡張、他PCからの接続を追加すると、認証・origin・アクセス制御の確認範囲が変わります。

• Ollama Windows公式docs - localhostとPowerShellの現行例を見る
• Ollamaモデル管理 - ls、ps、show、rmの順番を確認する
• ローカルLLMの安全性 - 保存・通信・権限・ログの確認へ進む

OpenAI互換のapi_key=ollamaを秘密鍵と混同しない

Ollama公式のOpenAI compatibility例では、local clientの初期化にapi_key=ollamaを指定します。これはclientが値を要求するためのlocal例で、公式コメントはrequired but ignoredです。local endpointの値を外部APIのBearer tokenや安全性の証明として再利用しないでください。

from openai import OpenAI

client = OpenAI(
    base_url="http://localhost:11434/v1/",
    api_key="ollama",  # local公式例。秘密鍵ではない
)

result = client.responses.create(
    model="MODEL",
    input="local endpointの認証境界を短く説明してください。",
)
print(result.output_text)

local OpenAI clientが「Authentication required」と表示しても、まずclient側の入力チェックと実際のHTTP送信先を分けます。逆に、local例が動いたからといってcloud APIへの認証が済んだことにはなりません。

• Ollama OpenAI compatibility公式docs - api_key=ollamaの公式コメントとbase URLを見る
• Ollama Responses API実装 - Python・JavaScript・PowerShellの接続例を見る
• ローカルAI API入門 - client・server・modelの役割を整理する

ollama signinでWindowsからcloud modelを使う

Ollama公式Cloud docsでは、cloud modelにはollama.comのアカウントが必要で、ollama signinを実行してからcloud modelをpull・runする例が示されています。local appのAPIを呼ぶ場合でも、指定したmodelが`:cloud`であれば、local serverがcloud serviceへ接続する経路として考えます。

ollama signin
ollama pull gpt-oss:120b-cloud
ollama run gpt-oss:120b-cloud

# ローカルAPI経由でcloud modelへ送る例
$payload = @{
  model = "gpt-oss:120b-cloud"
  messages = @(@{ role = "user"; content = "短い質問" })
  stream = $false
} | ConvertTo-Json -Depth 8
Invoke-RestMethod `
  -Uri "http://localhost:11434/api/chat" `
  -Method Post `
  -ContentType "application/json" `
  -Body $payload

cloud modelの名称、提供状況、retirement、推論場所は変わる可能性があります。gpt-oss:120b-cloudは公式docsの説明例であり、利用時点のOllama model libraryとアカウント状態を優先し、この記事を特定modelの永続的な提供保証として扱いません。

• Ollama Cloud公式docs - signin、pull、local API経由のcloud例を見る
• Ollamaのlocal/cloud比較 - 通信・PC負荷・privacyの違いを確認する
• OllamaのAPI認証公式docs - local APIとcloud authの説明を見る

https://ollama.com/apiへAPI keyで直接接続する

Ollama公式API Introductionでは、localのbase URLがhttp://localhost:11434/api、cloudを直接使うbase URLがhttps://ollama.com/apiと分けられています。直接cloud APIへ接続する場合はAPI keyを作成し、Authorization: Bearer headerで渡します。Windowsでは秘密鍵をソースやコマンドへ直書きせず、既に安全に設定した環境変数から読みます。

# 事前にWindowsのユーザー環境変数へOLLAMA_API_KEYを安全に登録しておく
$apiKey = [Environment]::GetEnvironmentVariable("OLLAMA_API_KEY", "User")
if ([string]::IsNullOrWhiteSpace($apiKey)) {
  throw "OLLAMA_API_KEY is not configured"
}

$headers = @{
  Authorization = "Bearer $apiKey"
}
$payload = @{
  model = "gpt-oss:120b"
  messages = @(@{ role = "user"; content = "短い質問" })
  stream = $false
} | ConvertTo-Json -Depth 8

Invoke-RestMethod `
  -Uri "https://ollama.com/api/chat" `
  -Headers $headers `
  -Method Post `
  -ContentType "application/json" `
  -Body $payload

1. OllamaのAPI keys設定で直接API用のkeyを作成し、値を画面・Git・ログへ貼り付けない。
2. Windowsのユーザー環境変数など、利用環境のsecret管理へOLLAMA_API_KEYを登録する。
3. 実行時に環境変数を読み、Authorization: Bearer headerを組み立てる。
4. 送信先がhttps://ollama.com/apiであること、localのlocalhost endpointではないことを確認する。
5. 使い終わったらプロセス、shell履歴、CIログ、proxyログにkeyが残っていないか確認する。

この例は外部通信を伴うため、利用者のアカウント、課金、利用規約、データ送信方針を確認してから実行します。このサイトのbuildや記事確認ではAPI keyを取得・表示・使用していません。

• Ollama Cloud API access - API key、/api/tags、/api/chatの公式例を見る
• Ollama Authentication公式docs - OLLAMA_API_KEYとBearer headerの説明を見る
• ローカルLLMの安全性 - 秘密情報・ログ・外部送信の確認へ進む

Windowsをlocal-only modeにしてcloud経路を止める

Ollama公式FAQでは、cloud featuresを無効にするとlocal-only modeにでき、cloud modelとweb searchが使えなくなると説明されています。`disable_ollama_cloud`を`~/.ollama/server.json`へ設定する方法と、`OLLAMA_NO_CLOUD=1`を使う方法があるため、組織のルールと運用方法に合う方を選びます。

# PowerShellで現在のユーザー環境変数へ設定する例
[Environment]::SetEnvironmentVariable("OLLAMA_NO_CLOUD", "1", "User")

# 設定後にOllamaを終了し、Windowsのスタートメニューから再起動する

# server.jsonで管理する場合の内容
{
  "disable_ollama_cloud": true
}

local-only modeは「すべての入力が安全」という意味ではありません。ローカルの履歴・ログ・MCP・ブラウザ拡張・proxy・他アプリへの権限は別に確認し、設定変更後は実際のOllamaログと送信先を記録してください。

• Ollama FAQ公式docs - OLLAMA_NO_CLOUD、server.json、Windows再起動の説明を見る
• ローカルRAGのプライバシー - 文書・embedding・保存先・ログを確認する
• Ollamaモデル保存場所 - 設定・モデル・ログの保存先を分ける

認証エラー・cloud接続・秘密情報を切り分ける

認証のトラブルは、local endpoint、cloud model、直接cloud API、Windows環境変数、Ollamaのsignin状態、modelの提供状況を一度に変えずに確認します。Ollama公式Errors docsの400・404・429・500・502とerror本文を記録し、認証情報を追加する前に送信先のURLを確定します。

• 実際のAPI URL、model名、認証方式、実行場所を最初の診断ログへ残す。
• API key、cookie、token、実文書を記事のコードやshell履歴へ貼り付けない。
• local endpointへ認証headerを足すことや、エラー回避のためにネットワーク公開を広げることを先に行わない。
• cloud modelの仕様、料金、retirement、privacyは利用時点の公式案内とアカウント画面を確認する。

• Ollama API Errors公式docs - statusとerror本文を記録する方法を見る
• OllamaのWindowsトラブル - localhost、server、model、APIの共通診断へ進む
• Ollamaのlocal/cloud比較 - 推論場所・通信・privacyを分ける