智谱AI开放平台的官方入口是 open.bigmodel.cn,注册后即可在个人中心创建 API Key 调用 GLM 系列模型。截至目前,平台最新旗舰模型为 GLM-5.3(1M 上下文,输入 8 元/百万 Tokens、输出 28 元/百万 Tokens),并长期提供 GLM-4.7-Flash 等免费模型。本文按入口、取 Key、模型价格、计费规则、报错排查、常见问题六个模块整理,数据均取自智谱开放平台官方文档与官方价格页。 智谱AI开放平台官方入口与官网地址
智谱把「开发者控制台」「API 文档」「体验中心」拆成了三个独立入口,初次接触容易走错门。常用官方地址如下:
注意区分:控制台与文档是「按量付费的开发者通道」,体验中心与智能体市场更偏向「产品化试用」;三者的模型单价一致,但体验中心的调用同样会计入你的账户消耗。
开放平台 API Key 获取步骤
按官方《快速开始》文档,从注册到第一次成功调用共 5 步:
- 登录后在个人中心页点击 API Keys,创建一个新的 API Key,建议按「项目名-环境」命名(如 blog-prod),方便后续按 Key 拆分用量;
- 妥善保管 API Key:官方文档明确要求不要泄露给他人、不要硬编码进代码,建议使用环境变量或配置文件存储,推荐创建后立即存入密码管理器;
- 选择模型并确认账户有可用余额——账户欠费时调用会返回业务错误码 1113(HTTP 429),而不是正常的模型响应,这是新手最常踩的一步;
- 发起首次调用,通用对话接口地址为 https://open.bigmodel.cn/api/paas/v4/chat/completions,请求头带 Authorization: Bearer YOUR_API_KEY,官方文档提供了 curl、Python SDK(zai-sdk / zhipuai)、Java SDK(ai.z.openapi:zai-sdk)三种示例。
补充两点官方口径:一是调用 API 目前并不强制实名认证,但官方建议在 实名认证页 完成认证以保障账户安全,个人人脸识别即时通过,企业营业执照授权认证约 7 个工作日;二是如果你订阅了 GLM Coding Plan,其 Key 与平台通用 API Key 不通用,必须使用套餐内创建的 Key,否则会触发错误码 1315。 平台模型清单与最新 API 价格一览
以下为主力模型的能力与上下文参数(来源:官方文档《模型概览》):
| | | |
|---|
| | | |
| 原生多模态,可理解图片/视频/文件,生成可交互代码 | | |
| | | |
| | | |
| 免费文本模型,延续 GLM-4.7 基座的通用能力 | | |
| 轻量图文解析,单图 ≤10MB、PDF ≤50MB、最多 100 页 | | |
官方定价(单位:元/百万 Tokens,来源:open.bigmodel.cn/pricing 与官方《API 定价》文档):
价格表有两条容易忽略的规则:一是分段计价,多数模型在输入或输出超过 32K Tokens 后进入更高单价档;二是图像、视频、语音类模型不按 Token 计费——GLM-Image 图像生成 0.1 元/次、CogVideoX-3 视频生成 1 元/次、GLM-TTS 语音合成 2 元/万字符、GLM-ASR-2512 语音识别输入 16 元/百万 Tokens。此外,Batch API 面向离线批量任务,按标准价五折计费。
智谱 API 的计费规则与免费额度
平台采用预充值 + 按量后扣费模式:先充值现金余额或购买资源包,调用时按实际用量扣减。官方给出的费用公式为:调用费用 = 未命中缓存的输入费用 + 缓存命中费用 + 输出费用 + 缓存存储费用。
- 扣减顺序:优先扣「资源包账户」,再扣「现金余额账户」;存在多个同场景资源包时,优先扣最快过期的那个。
- Token 换算:GLM 系列模型 Token 与汉字比例约为 1:1.6,实际以接口返回的用量数据为准。
- 免费额度:平台长期提供完全免费的 API 模型,包括文本类的 GLM-4.7-Flash、GLM-4.5-Flash、GLM-4-Flash-250414,视觉类的 GLM-4.6V-Flash、GLM-4.1V-Thinking-Flash、GLM-4V-Flash,以及生成类的 CogView-3-Flash、CogVideoX-Flash;官网首页会不定期推出新用户注册赠送 Tokens 的限时活动,额度与有效期以活动页当时展示为准。
- 用户权益等级:按近三个月最高积分划分 V0(0–2,000)、V1(2,000–10,000)、V2(10,000–50,000)、V3(≥50,000)四档,等级越高可获得的模型并发越高;消费现金与购买资源包按 1:1 累积积分,赠金消耗不计积分,等级于 T+1 日 06:00 更新。
- 退款:官方明确表示平台不支持任意形式的退款,未消费的充值金额仅在特殊情况下可联系客服申请,已开票部分不予退款。
建议在生产环境上线前,先到 财务总览 设置用量关注,并在 用户权益页 确认自己当前等级对应的并发额度。 常见报错与错误码速查表
智谱 API 的响应码由「外层 HTTP 状态码 + 内层业务错误码」两部分组成,业务错误码才是定位问题的关键。以下为官方文档《错误码》中最高频的一批:
| | | |
|---|
| | Header 中未收到 Authentication 参数 | 检查请求头是否漏了 Authorization: Bearer |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
| | | |
排错提示:一是使用流式(SSE)调用时,若推理中途异常终止,不会返回上述错误码,而是在响应体的 finish_reason 中给出原因;二是遇到 429 时先看业务错误码再动手,1113 是欠费、1302 是并发超限、1305 是平台侧过载,三者的处理方式完全不同。通用 API 用户如需更高并发,可在 速率限制调整申请页 提交申请,官方承诺 10 个工作日内完成审核;GLM Coding Plan 用户按订阅等级(Max > Pro > Lite)统一并发,暂不支持申请调整。 智谱开放平台常见问题
Q:智谱AI开放平台是免费的吗?
A:注册和登录不收费,平台长期提供 GLM-4.7-Flash 等免费模型可直接调用;付费模型按 Token 计费,需要先充值现金余额或购买资源包。
Q:官方入口到底是哪个域名?
A:开发者控制台与价格页是 open.bigmodel.cn,接口文档是 docs.bigmodel.cn,密钥管理在 bigmodel.cn/usercenter/proj-mgmt/apikeys,认准这三个即可。
Q:不做实名认证能调用 API 吗?
A:官方 FAQ 明确「目前调用 API 并不强制要求实名认证」,但建议完成认证以保障账户安全,企业账号还可用对公打款充值。
Q:返回 429 一定是被限流了吗?
A:不一定。1113 表示欠费、1302 表示达到账户速率限制、1305 表示平台侧过载、1308/1310 表示达到周期使用上限,要看业务错误码区分处理。
Q:怎么用最省钱?
A:开发测试阶段用免费模型;离线批量任务走 Batch API 享五折;长对话复用上下文以命中缓存(命中单价远低于普通输入);合理设置 max_tokens 减少无效输出。
Q:可以用 OpenAI 的 SDK 调用吗?
A:可以。平台接口兼容 OpenAI 协议,同时提供 zai-sdk / zhipuai(Python)与 ai.z.openapi:zai-sdk(Java)官方 SDK;GLM Coding Plan 需使用专属 Base URL,如 https://open.bigmodel.cn/api/coding/paas/v4。
Q:并发不够用怎么办?
A:通用 API 用户可通过提升用户权益等级(消费累积积分)或提交速率限制调整申请来提高并发,审核周期 10 个工作日;Coding Plan 用户则需升级 Lite/Pro/Max 套餐等级。
Q:一个 API Key 能通吃所有场景吗?
A:不能。团队编程套餐的 Key 与平台通用 API Key 不通用,用错会触发错误码 1315,团队额度务必使用团队套餐内创建的 Key。
Q:数据合规和私有化部署怎么解决?
A:平台提供模型私有实例、云端私有化年套餐与本地私有化一体机三类方案,另有独立的企业权益体系;具体报价与合规条款需通过官网商务通道沟通,以最终合同为准。
以上内容仅供参考,模型清单、价格、权益等级与错误码说明可能随官方更新而变动,请以智谱AI开放平台官方文档(docs.bigmodel.cn)与官方价格页(open.bigmodel.cn/pricing)最新公布为准。