Skip to main content
Glama

GLM-Vision — 免费视觉桥接(Skill + MCP)

用智谱完全免费的 GLM-4.6V-Flash 视觉模型,给 DeepSeek 等纯文本模型装上"眼睛": 图片/截图/OCR/图表/扫描文档 → 文字理解,无缝接入 agent。

特性

  • 完全免费glm-4.6v-flash,128K 上下文,OpenAI 兼容接口

  • 自动轮换:429 限流/5xx 时自动降级到其他免费视觉模型(glm-4.1v-thinking-flashglm-4v-flash

  • 双形态:MCP 原生工具 + CLI 兜底(同一份核心代码)

  • 零依赖核心glm_vision.py 纯 Python 标准库,无需 pip

  • 本地 + URL:本地图片自动 base64,URL 直传

  • 6 大能力:描述 / OCR / 图表 / 文档 / 截图 / 定位(grounding)

Related MCP server: vision-mcp

快速开始

1. 获取 API Key(免费)

  1. 注册:https://open.bigmodel.cn (智谱开放平台,手机号即可)

  2. 进入 API Keys 创建密钥

  3. glm-4.6v-flash 免费,无需充值

2. 配置 Key(三选一,按优先级)

# 方式 A:环境变量(推荐,最安全)
#   Windows 永久设置:
setx ZHIPU_API_KEY "你的key"
#   PowerShell 当前会话:
$env:ZHIPU_API_KEY="你的key"

# 方式 B:全局配置文件
mkdir -p ~/.config/glm-vision
# 写入 config.json:
# {
#   "api_key": "你的key",
#   "base_url": "https://open.bigmodel.cn/api/paas/v4/chat/completions",
#   "model": "glm-4.6v-flash",          # 可选:固定单模型(不轮换)
#   "models": ["glm-4.6v-flash", "glm-4.1v-thinking-flash", "glm-4v-flash"]  # 可选:自定义轮换顺序
# }

# 方式 C:本目录 .env 文件
# ZHIPU_API_KEY=你的key

3. 安装 MCP 服务器依赖

pip install mcp

4. 注册到 opencode

opencode.json(或 ~/.config/opencode/opencode.jsonc)的 mcp 字段添加:

"mcp": {
  "glm-vision": {
    "type": "local",
    "command": ["python", "E:/tool/.opencode/skills/glm-vision/mcp_server.py"],
    "enabled": true
  }
}

重启 opencode 生效。

CLI 用法

python glm_vision.py describe <图片路径或URL> [-q "问题"] [--no-thinking]
python glm_vision.py ocr <图片路径或URL> [--no-thinking]
python glm_vision.py chart <图片路径或URL> [-q "问题"]
python glm_vision.py document <图片路径或URL> [-q "问题"]
python glm_vision.py screenshot <图片路径或URL> [-q "问题"]
python glm_vision.py grounding <图片路径或URL> "目标元素" 

# 自定义轮换顺序(逗号分隔)或固定单模型
python glm_vision.py describe <图片> --models glm-4v-flash,glm-4.6v-flash
python glm_vision.py describe <图片> --model glm-4.6v-flash

Python API

from glm_vision import analyze_image
print(analyze_image(["screenshot.png"], mode="ocr"))
print(analyze_image(["https://example.com/chart.png"], mode="chart", question="最高点是哪个月"))

文件结构

glm-vision/
├── SKILL.md           # opencode skill 定义(触发词 + 使用指南)
├── glm_vision.py      # 核心库 + CLI(纯 stdlib,零依赖)
├── mcp_server.py      # MCP 服务器(需要 pip install mcp)
├── requirements.txt   # 仅 mcp
├── examples/
│   └── demo.md        # 示例

常见问题

问题

解决

HTTP 429

免费模型限流,内置重试;仍失败会自动降级到下一个免费视觉模型(轮换),全部失败才报错

图片太大

>10MB 自动压缩(需 pip install pillow

没有 response

检查 Key、网络(bigmodel.cn 国内可直连)

想换模型

config.jsonmodel 字段;或用 --models / --model CLI 参数;models 数组自定义轮换顺序

免责声明

  • 免费模型的速率限制可能随官方策略变化

  • 请遵守智谱开放平台使用条款;不上传违反法律法规的内容

Related MCP Connectors

Related MCP Servers