Ollama API 查看模型详情

POST /api/show 返回模型的元信息：参数配置、支持的能力、思考档位、架构细节。它是「这个模型能做什么」的权威来源——比看文档猜更可靠。

版本基线 v0.40.12，官方 docs.ollama.com/api-reference/show-model-details。

一、调用

curl http://localhost:11434/api/show -d '{
  "model": "gemma4"
}'

二、最该关注的字段：capabilities

这是接入工具前的必查项：

"capabilities": ["completion", "thinking", "vision"]

模型没有 tools，工具调用就一定不work。编码代理接不上、工具不触发，第一个要查的就是这里。

三、thinking 档位

"thinking": {
  "values": [false, true],
  "default": true
}

values 是该模型接受的全部取值，default 是默认值。

有些模型支持命名档位（如 "low"、"high"），此时 values 会是字符串数组。调用时 think 字段传的值必须和这里完全一致，否则回落到默认。

没有思考元数据的模型不会返回这个字段。

四、其他响应字段

template_source 的取值

这个字段解释模型到底怎么渲染提示词：

排查「为什么输出格式不对」时这个字段很有用——如果 template_source 是 parser，那你改 Modelfile 里的 TEMPLATE 是无效的。

verbose 参数

curl http://localhost:11434/api/show -d '{
  "model": "gemma4",
  "verbose": true
}'

verbose: true 会返回大体积字段（完整的 model_info、tokenizer 配置等）。默认不开是因为 model_info 可能有上百个键。

五、model_info 里值得看的几项

"model_info": {
  "gemma4.context_length": 131072,
  "gemma4.block_count": 42,
  "gemma4.embedding_length": 2560,
  "gemma4.attention.head_count": 8,
  "gemma4.attention.head_count_kv": 2,
  ...
}

context_length: 131072 表示这个模型理论上支持 128k 上下文——但实际能用多少还取决于显存。运行时真实分配值看 /api/ps 的 context_length。

六、Python 示例

import requests

info = requests.post("http://localhost:11434/api/show", json={"model": "gemma4"}).json()

print("能力:", info.get("capabilities"))
print("参数:", info.get("parameters", "").replace("\n", " | "))
print("量化:", info["details"]["quantization_level"])
print("参数量:", info["details"]["parameter_size"])

## 找上下文长度（键名带模型前缀，需模糊匹配）
for k, v in info.get("model_info", {}).items():
    if k.endswith(".context_length"):
        print(f"最大上下文: {v}")
        break

## 思考档位
t = info.get("thinking")
if t:
    print(f"思考档位: {t['values']}  默认: {t['default']}")

常见问题

动手试

## ① 查能力（接任何工具前先跑这个）
curl -s http://localhost:11434/api/show -d '{"model":"gemma4"}' | python -c "
import sys,json
d=json.load(sys.stdin)
print('能力:', d.get('capabilities'))
print('最大上下文:', [v for k,v in d.get('model_info',{}).items() if k.endswith('.context_length')])"

## ② 看参数配置
curl -s http://localhost:11434/api/show -d '{"model":"gemma4"}' | python -c "
import sys,json;print(json.load(sys.stdin).get('parameters'))"

第一条返回的 capabilities 决定了这个模型能接哪些工具。