智谱免费模型 API 怎么调（2026）：GLM-4.7-Flash、视觉 Flash 和生图生视频

数据来自官方和社区，未经本站实测。

搜「智谱 免费 API」，最常见的答案是「GLM-4.7-Flash 免费」。这句话没错，但不完整：智谱定价页上标「免费」的不止一个模型，有的已经下线，还有一批名字也带 Flash 的型号是收费的。这篇把现在还能用的免费模型列清楚，再一步步写怎么拿 Key、怎么调用、会被什么限制住。

先看结论：现在能免费用的模型

下表是 2026-11-12 定价页上单价写「免费」、并且模型页没有写下线的模型。

两个不要再用的免费型号：

• GLM-Z1-Flash：定价页上价格仍写「免费」，但它的模型页顶部写明「GLM-Z1 系列模型已下线」，模型概览的文本模型列表里也没有它。定价页底部说明过，历史模型的价格会继续保留，当前是否可用要看模型概览。所以不要把它写进新代码。
• GLM-4.5-Flash：模型页写明 2026 年 1 月 30 日下线，下线后请求会自动转到 GLM-4.7-Flash。代码里还写着它的，建议直接改成 glm-4.7-flash。

一句话：文本用 GLM-4.7-Flash，看图用 GLM-4.6V-Flash，生图生视频各有一个免费款。

名字带 Flash，不一定免费

智谱的命名里，Flash 是免费款，FlashX 是收费的高速版，新一代的 Flash 也收费。下面这些都按 Token 计费（定价页，单位：元/百万 Tokens）：

复制模型代码时多看一眼结尾有没有 X，以及版本号是不是 5.3。只要模型名写错，请求就会按收费模型扣余额。

第一步：注册、拿 API Key

1. 打开智谱开放平台，注册并登录。
2. 进入个人中心的 API Keys 页面，新建一个 Key。
3. 把 Key 放进环境变量，不要直接写在代码里。官方建议的变量名是 ZAI_API_KEY。

export ZAI_API_KEY="你的 API Key"

两点要注意：

• 实名不是必须的。官方常见问题写明，目前调用 API 不强制要求实名认证，但建议做实名，保障账户安全。个人做人脸识别认证，通过后即时完成。
• 新建 Key 要选对类型。2026 年 10 月 16 日起，标准 API Key、个人编程套餐 Key、团队编程套餐 Key 分开管理，互不通用。调免费模型用标准 API Key 就行，在上面那个 API Keys 页面创建。

第二步：调用 GLM-4.7-Flash

接口兼容 OpenAI 的对话补全格式，地址是 https://open.bigmodel.cn/api/paas/v4/chat/completions。

curl：

curl -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-4.7-flash",
    "messages": [
      {"role": "user", "content": "用三句话介绍一下你自己"}
    ],
    "thinking": {"type": "enabled"}
  }'

OpenAI SDK（Python）： 官方要求 OpenAI SDK 1.0.0 以上，只需要改 Key 和基础地址。

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.getenv("ZAI_API_KEY"),
    base_url="https://open.bigmodel.cn/api/paas/v4/",
)

resp = client.chat.completions.create(
    model="glm-4.7-flash",
    messages=[{"role": "user", "content": "用三句话介绍一下你自己"}],
)
print(resp.choices[0].message.content)

官方也有自己的 Python SDK，安装命令是 pip install zai-sdk，用法和上面类似，见 GLM-4.7-Flash 模型页。

关于思考模式：思考模式文档写明 GLM-4.7 系列默认开启思考。只想要快速回答（改措辞、问个事实），可以在请求里传 "thinking": {"type": "disabled"}。文档只写了 GLM-5.3 和 GLM-5.3-Flash 不能关闭思考，GLM-4.7-Flash 不在其中。用 OpenAI SDK 时，这个参数不是 SDK 自带的参数，要作为额外的请求内容传进去：

resp = client.chat.completions.create(
    model="glm-4.7-flash",
    messages=[{"role": "user", "content": "把这句话改得更口语一点：……"}],
    extra_body={"thinking": {"type": "disabled"}},
)

看图：GLM-4.6V-Flash

看图模型用同一个接口，content 改成图片加文字。官方示例用的是公网图片地址：

curl -X POST "https://open.bigmodel.cn/api/paas/v4/chat/completions" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $ZAI_API_KEY" \
  -d '{
    "model": "glm-4.6v-flash",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "image_url", "image_url": {"url": "图片的公网地址"}},
        {"type": "text", "text": "这张图里写了什么？"}
      ]
    }]
  }'

模型页写明 GLM-4.6V-Flash 支持图片、视频和文件输入，适合识别截图、表格、单据里的文字。需要多步推理（读图表、解题）时，可以换 glm-4.1v-thinking-flash。生图、生视频的免费模型调用方式不同，见文末的站内推荐。

限流：只限并发，具体数字在控制台

智谱对免费模型没有公布「每天多少次」这类额度，限制的是并发，也就是同一时刻正在处理的请求数。

• 按账户、按模型分别限：每个模型有自己的并发上限，可以在控制台的速率限制页面查看。免费模型的具体并发数，文档没有写，待核实。
• 并发和用户等级挂钩：等级分 V0 到 V3，按积分算。积分只来自消耗现金余额或购买资源包（1 元记 1 分），赠金和资源包里的 Token 不算。只调免费模型不花钱，按这个规则积分不会增加，等级停在 V0。
• 超了会报错：错误码 1302 是账户触发速率限制，要降低并发或排队；1305 是模型整体访问量过大，稍后重试，不要立即高频重试。
• 可以申请提高：通过控制台的速率限制调整申请提交，官方写明 10 个工作日内审核。

免费模型会不会扣钱

单纯调用上表里的免费模型，单价就是免费。下面几种情况要注意：

• 模型名写错：写成 FlashX 或其他收费模型，就按 Token 扣现金余额。扣费顺序是先扣资源包，再扣现金余额。
• 联网搜索单独计价：定价页上的搜索工具按次收费，基础版 Search-Std 是 0.01 元/次。费用问题页面还写明，开启搜索服务后，搜索结果也会作为输入计费。免费模型配合搜索工具时到底收不收这笔费用，文档没有单独说明，待核实。不需要的话就不要开。
• 体验中心和 API 规则一样：官方写明体验中心和 API 调用按同样的单价计费，按这个规则，免费模型在体验中心试用也不收费。
• 欠费会被拦：错误码 1113 是账户欠费。账户余额为负时，调免费模型会不会也被拦，文档没写，待核实。
• 不用了就删 Key：官方写明 API Key 删除后无法再调用，也不会产生扣费。

查看用量和花费：财务总览和费用账单。

接进其他工具

因为兼容 OpenAI 接口，只要工具支持「自定义 OpenAI 地址」，基础地址填 https://open.bigmodel.cn/api/paas/v4/，模型填 glm-4.7-flash，就能接进去。想把智谱和其他平台的 Key 放在一个入口里管理，可以看站内的开源 API 网关对比。

编程工具里常见的另外两个地址（/api/coding/paas/v4 和 /api/anthropic）跟编程套餐有关。官方说明里，用标准 Key 调这些地址按标准 API 规则计费，但免费模型在这些地址上是否同样免费，文档没有直接写，待核实。只想用免费模型，就用上面的标准地址。

平台服务条款和各模型的使用限制，以智谱开放平台的协议原文为准。

怎么选

• 日常对话、写代码、翻译：glm-4.7-flash。上下文 200K，最大输出 128K，是目前免费款里规格最高的。
• 旧项目还在用 GLM-4-Flash：可以继续用 glm-4-flash-250414，但最大输出只有 16K，新项目建议直接用 4.7-Flash。
• 识别截图、表格、单据：glm-4.6v-flash；要看图推理，用 glm-4.1v-thinking-flash。
• 偶尔生图、生视频：cogview-3-flash 和 cogvideox-flash。
• 要推理模型：GLM-Z1-Flash 已下线，定价页上免费的文本模型里已经没有单独的推理模型。GLM-4.7-Flash 自带思考模式，可以先用它。

小结

• 2026-11-12 智谱定价页上标「免费」、并且没有下线的模型有 7 个：文本 2 个、视觉 3 个、生图 1 个、生视频 1 个。
• GLM-Z1-Flash 定价页上还写着免费，但模型页写明已下线；GLM-4.5-Flash 已在 2026-01-30 下线，请求会转到 GLM-4.7-Flash。
• 名字带 FlashX 的、GLM-5.3-Flash 都收费，复制模型代码时看清楚。
• 调 API 不强制实名；新建 Key 选标准 API Key。
• 免费模型只限并发，不公布每日次数；具体并发数在控制台里看，触发限流会返回 1302。

站内推荐

• 在自己电脑上把几家官方 Key 收进一个入口：new-api 本机 Docker 部署：只在 127.0.0.1 上，用官方 Key 统一管理自己的几家 API
• 其他平台的免费文本模型：国内大模型 API 免费额度一张表（2026）
• 免费生图接口对比，含 CogView-3-Flash：国内免费生图 API 对比：硅基流动、智谱、百炼等 6 家
• 免费生视频接口，含 CogVideoX-Flash：国内生视频 API 免费额度盘点：智谱、百炼、火山谁能白用
• 怕用着用着被扣费：免费额度用完会扣费吗：百炼「用完即停」、火山「安心体验」怎么开
• 把几家的 Key 放到一起管：new-api 和 sub2api 怎么选：开源 AI API 网关对比
• 更多国内免费额度：国内 AI 免费额度汇总