Z.ai 免费 GLM 调用

通过 Z.ai（智谱国际版）OpenAI 兼容接口，调用永久免费的 GLM 模型。
适合：中文处理、代码、Agent、长文档（~200K 上下文）、图像理解。

前置条件（Setup）

1. 去 https://z.ai/model-api 注册（点 Sign Up，支持邮箱 / Google / GitHub SSO，免信用卡、免手机）。
2. 登录后在 https://z.ai/manage-apikey/apikey-list 创建 API Key（该链接会先跳登录页 chat.z.ai/auth）。
3. 设为环境变量：
   bash export ZAI_API_KEY="你的key"
   （国内版 open.bigmodel.cn 需要国内手机号注册；本 skill 默认用国际版 api.z.ai。）

免费模型（当前）

• glm-4.7-flash（默认，~200K 上下文，偏 coding / agent）
• glm-4.5-flash（128K，轻量通用）
• glm-4.6v-flashx（视觉 / 推理版，可图文输入；用户实测可用）

免费层限制：1 并发、~1 次/秒（单人工具 / 串行批处理足够；不适合多用户并发的公网应用）。

用法

问题作为位置参数传入：

python scripts/chat.py "用 GLM 给我写一段 3D 打印店铺的小红书文案" \
  [--model glm-4.7-flash] [--system "你是资深电商运营"] [--max-tokens 4096]

也可从 stdin 读：

echo "把这句话翻译成英文：今天发货" | python scripts/chat.py

国内网络说明

• 默认端点 https://api.z.ai/api/paas/v4（国际版）。
• 若你的网络访问不稳，可切国内版（key 需国内手机号注册）：
  bash export ZAI_BASE_URL="https://open.bigmodel.cn/api/paas/v4"

错误处理

• 未设 ZAI_API_KEY → 脚本打印清晰的设置指引并退出（不会崩溃）。
• HTTP 错误（如 401 无效 key）→ 打印状态码与错误详情。