Ollama API 获取版本

GET /api/version 返回服务端版本号。这是最轻量的「服务是否活着」探针。

版本基线 v0.40.12，官方 docs.ollama.com/api-reference/get-version。

一、调用

curl http://localhost:11434/api/version

返回：

{ "version": "0.12.6" }

就一个字段。

二、三个实用场景

1. 健康检查

if curl -sf http://localhost:11434/api/version > /dev/null; then
  echo "Ollama 在运行"
else
  echo "Ollama 未启动"
fi

-s 静默、-f 遇到错误码返回非零——组合起来就是标准探针。

2. 启动前的版本门禁

不同功能有最低版本要求，部署脚本里应该先校验：

#!/usr/bin/env bash
REQ="0.40.0"
CUR=$(curl -s http://localhost:11434/api/version | python -c "import sys,json;print(json.load(sys.stdin)['version'])")

if [ "$(printf '%s\n%s\n' "$REQ" "$CUR" | sort -V | head -1)" != "$REQ" ]; then
  echo "版本过低：需要 >= $REQ，当前 $CUR"
  exit 1
fi
echo "版本 OK: $CUR"

3. 容器编排里的 liveness probe

Kubernetes 里作为 HTTP 探针：

livenessProbe:
  httpGet:
    path: /api/version
    port: 11434
  initialDelaySeconds: 10
  periodSeconds: 30

三、各功能的版本门槛

部署前值得对照一下：

看版本号就能快速判断「文档里说的功能我这能不能用」。

四、和 CLI 版本对照

## 服务端版本
curl -s http://localhost:11434/api/version

## CLI 版本
ollama --version

两者一般是同一个版本，但理论上可以不一致——比如你手动升级了 CLI 但没重启服务进程。排查奇怪问题时对比一下有价值。

五、Python 示例

import requests

def get_version(host="http://localhost:11434"):
    try:
        r = requests.get(f"{host}/api/version", timeout=3)
        r.raise_for_status()
        return r.json()["version"]
    except Exception as e:
        return f"不可达: {e}"

print(get_version())

设 timeout=3 很重要——服务未启动时默认超时可能等很久。

常见问题

动手试

## ① 本地版本
curl -s http://localhost:11434/api/version

## ② 对比 CLI
ollama --version

## ③ 一条命令判断服务可用性
curl -sf http://localhost:11434/api/version && echo " OK" || echo " 服务不可用"