智谱 GLM API 接入教程：GLM-5 与全系列模型使用指南（2026）

2026-08-05 AI API 智谱 GLM 教程

智谱 AI 是国内最早的大模型厂商之一，GLM 系列在中文理解与智能体（Agent）工程上表现突出。2026 年的 GLM-5 在 SWE-bench Verified、Terminal Bench 2.0 等智能体编程榜单达到开源模型 SOTA，比肩 Claude Opus 4.5；同时智谱接口同时兼容 OpenAI 与 Anthropic SDK，灵活度很高。

一、注册与获取 API Key

  1. 访问 智谱开放平台（open.bigmodel.cn）注册
  2. 完成实名认证后，在控制台「API Keys」创建 Key
  3. 智谱的 Key 是两段式（id.secret 格式，如 xxxx.yyyy），整体作为 Bearer token 使用，不要拆开

GLM-4.5-Air 等模型在部分平台有免费额度，可先白嫖再付费。

二、Base URL 与模型速查

项 值
Base URL https://open.bigmodel.cn/api/paas/v4
旗舰 Agent glm-5 / glm-5.1（编码与工具调用 SOTA）
高性价比 glm-4.5-air / glm-4.5-flash（部分免费）
视觉推理 glm-4.6v（128K 上下文，原生工具调用）

模型 ID 一律小写连字符风格，如 glm-4.5-air；写成 GLM-5 这类大写会被判为模型不存在（404）。

三、快速接入示例

curl：

curl https://open.bigmodel.cn/api/paas/v4/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_GLM_KEY" \
  -d '{"model": "glm-4.5-air", "messages": [{"role": "user", "content": "你好"}]}'

Python（OpenAI SDK）：

from openai import OpenAI

client = OpenAI(
    api_key="id.secret 格式的key",
    base_url="https://open.bigmodel.cn/api/paas/v4",
)
resp = client.chat.completions.create(
    model="glm-4.5-air",
    messages=[{"role": "user", "content": "解释什么是智能体（Agent）"}],
)
print(resp.choices[0].message.content)

四、在本站后台的配置方法

「站点设置 → AI 对话 → 模型接入」新增提供商：

  • 名称：智谱 GLM
  • Base URL：https://open.bigmodel.cn/api/paas/v4
  • 模型：glm-4.5-air（或 glm-5）
  • API Key：填入你的 id.secret Key

注意：Base URL 填到 /v4 即可，不要带 /chat/completions——系统会自动拼接。

五、价格参考（2026 年中整理，以官方为准）

模型 输入（元/百万 token） 输出
glm-4.5-flash 部分平台免费 —
glm-5 约 6（按上下文分层） 约 24

六、踩坑提示

  1. Base URL 别填完整路径：正确为 .../api/paas/v4，填成带 /chat/completions 会 404
  2. 两段式 Key 整体使用：id.secret 是一个整体，中间的点不是分隔符
  3. 编程套餐：重度使用可考虑 Coding Plan（月费制），比按量便宜很多
  4. GLM-5 适合 Agent：工具调用、长链路执行是它的强项，普通闲聊用 air/flash 更划算

七、适用场景

编码与智能体工程（GLM-5）、中文内容生成、需要视觉理解（GLM-4.6V）、希望同一套代码兼容 OpenAI/Anthropic 两种生态。

← 返回博客列表