智谱BigModel免费额度怎么领：GLM-4-Flash长期免费调用与新用户赠送

智谱 BigModel 提供与 OpenAI 风格兼容的接口，把 base_url 指向 https://open.bigmodel.cn/api/paas/v4 即可，SDK 与 HTTP 两种方式都能调通。

一、常用模型名与获取途径

免费档常见模型包括 glm-4-flash、glm-4.6v-flash（多模态）、glm-z1-flash 等，写作本文时 GLM-4-Flash 系列、GLM-4.7-Flash、GLM-Z1-Flash、GLM-4.6V-Flash 属于免费调用范围。免费清单会调整，最准确的做法是登录控制台打开「模型广场 / 模型页」逐个确认，那里标注的免费标识和上下文长度才是当前有效信息。

二、用 curl 发起一次对话补全

先把密钥放进环境变量，避免写死在代码里：

export ZHIPU_API_KEY="你的 API Key"

然后发送标准的对话补全请求，注意 messages 里的 role 取值为 system、user、assistant：

curl https://open.bigmodel.cn/api/paas/v4/chat/completions \
  -H "Authorization: Bearer $ZHIPU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "glm-4-flash",
    "messages": [
      {"role": "system", "content": "你是一个简洁的中文助手"},
      {"role": "user", "content": "用一句话解释什么是 API"}
    ],
    "temperature": 0.7,
    "max_tokens": 512,
    "stream": false
  }'

三、关键参数说明

• model：必填，填控制台模型页里确认过的模型标识，拼错会直接返回模型不存在。
• messages：必填，对话数组，按时间顺序排列，system 放最前用于设定人设与输出约束。
• temperature：可选，0 到 1 之间，越低越稳定，做结构化输出时建议调到 0.1 附近。
• max_tokens：可选，限制本次回复长度，设置过小会导致内容被截断。
• stream：可选，设为 true 时返回 SSE 流式数据，前端做打字机效果时使用。
• tools：可选，免费模型支持函数调用，需要让模型调用外部工具时按函数调用格式传入。

四、Python 调用示例

用官方 SDK 时只需换 base_url 或用智谱专用 SDK，下面这段可直接改动运行：

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["ZHIPU_API_KEY"],
    base_url="https://open.bigmodel.cn/api/paas/v4"
)

resp = client.chat.completions.create(
    model="glm-4-flash",
    messages=[{"role": "user", "content": "写一句产品介绍，不超过 20 字"}],
    temperature=0.5,
    max_tokens=128
)

print(resp.choices[0].message.content)

五、额度耗尽与限流的典型表现

常见的三种报障：一是返回鉴权失败，说明密钥不对、被删除或请求头少了 Bearer 前缀；二是返回余额或资源包不足，说明赠送 tokens 已用尽或误调了付费模型；三是返回频率/并发超限，免费档并发通常为 1，多线程同时请求必然触发。

排查顺序建议为：先核对密钥与请求头，再确认 model 名称是否仍在免费清单内，然后到控制台查看资源包剩余量与调用日志，最后检查自身代码是否存在并发或重试风暴。若确实需要提升并发，需要在控制台申请或改用付费档，具体规则以控制台实际显示为准。