​

Ollama Pro 云端模型

​

先核对了什么

• 当前版本的 Pi 内置 provider 和 /login 流程不是 Ollama 接入路径。
• 不要在 Pi OAuth 凭据中猜造 Ollama 条目，也不要假设 pi login 能授权 Ollama。
• Orbi 必须使用 Pi models.json 形状的自定义 pi_providers 文件，配置 Ollama 的 OpenAI-compatible 云端 endpoint 和 API key 引用。

​

准备 Ollama 访问

1. 在 ollama.com 登录或注册。如果也使用本地 Ollama CLI，官方准备命令是：
   ollama signin
   
   这不是 Pi 或 Orbi 的登录命令。
2. 在 ollama.com/settings/keys 创建 API key。它是账号秘密，绝不能粘贴进本仓库、Issue、日志或 commit。
3. 把 key 放入 Orbi/systemd 使用的本地 gitignored 环境文件：
   mkdir -p .orbi
   printf '%s\n' 'OLLAMA_API_KEY=替换为你的key' > .orbi/env
   chmod 600 .orbi/env
   
4. 不要从本文固定抄模型名，先查询账号当前 catalog。Ollama 官方记录的认证 endpoint 是：
   set -a; . .orbi/env; set +a
   curl -fsS https://ollama.com/api/tags \
     -H "Authorization: Bearer $OLLAMA_API_KEY"
   
   返回值是请求时账号/API 可见的 catalog。官方云端示例在 direct API 中使用 gpt-oss:120b；这只是示例，不代表额度或可用性保证。本地 CLI 的云端 tag（如 gpt-oss:120b-cloud）也不自动等于 direct API 的 model ID。

​

最小 Orbi 配置

{
  "providers": {
    "ollama-pro": {
      "baseUrl": "https://ollama.com/v1",
      "api": "openai-completions",
      "apiKey": "$OLLAMA_API_KEY",
      "models": [
        {
          "id": "gpt-oss:120b",
          "name": "Ollama 云端模型（请以 /api/tags 核对）",
          "contextWindow": 131072,
          "maxTokens": 16384
        }
      ]
    }
  }
}

pi_providers = ".orbi/pi-providers.json"
pi_provider = "ollama-pro"
pi_model = "gpt-oss:120b"

set -a; . .orbi/env; set +a
PYTHONPATH=src python3 -m orbi.runner --config orbi.toml

​

额度、错误和证据边界

​

最小 fallback diff

-pi_provider = "ollama-pro"
-pi_model = "gpt-oss:120b"
+pi_provider = "local-qwen"
+pi_model = "Qwen3.8-27B"

​

安全清单

• .orbi/env 和本地 .orbi/pi-providers.json 不进 Git；JSON 使用 $OLLAMA_API_KEY，绝不写字面量 key。
• 不要把 key 放入 Issue、PR、session transcript、shell history 或诊断日志。
• model ID 和 HTTP 状态只有在删除 Authorization header 与响应数据后才适合分享。
• Ollama Pro 的订阅有效期和额度会变化；生产任务前重新检查官方 catalog 和计划条款。