智谱开放平台 API Key 是程序调用模型的凭证。获取它的正确起点是官方开发者平台,而不是清言聊天页或第三方“共享密钥”。创建后先用一个最小请求验证鉴权,再把 Key 留在本机安全位置;验证时不要把完整 Key 打印、截图或贴进问题帖。
从官方控制台创建 Key
智谱快速开始说明:进入开放平台完成注册登录,在个人中心的 API Keys 页面创建新 Key。不同账号可能还需按页面提示完成认证、额度或项目设置;以登录后的实际界面为准。新建后复制到密码管理器或本机环境变量,勿放入网页前端、公开仓库或共享文档。

用最小请求验证鉴权
官方HTTP API 文档采用 Authorization: Bearer YOUR_API_KEY 请求头和 /api/paas/v4/chat/completions 路径。下面的 Python 例子从环境变量读取 Key;先运行 pip install requests,并在同一终端会话设置 ZHIPU_API_KEY:
import os
import requests
key = os.environ["ZHIPU_API_KEY"]
response = requests.post(
"https://open.bigmodel.cn/api/paas/v4/chat/completions",
headers={"Authorization": f"Bearer {key}"},
json={
"model": "glm-5.3",
"messages": [{"role": "user", "content": "只回复:连接正常"}],
"stream": False,
},
timeout=60,
)
print("HTTP 状态:", response.status_code)
if response.ok:
print(response.json()["choices"][0]["message"]["content"])
else:
print("请求未通过;在私有环境检查账号、Key、权限和额度")
这个请求会产生实际 API 调用,可能消耗账户额度;模型名称也应按你账号当前可用列表核对。成功时应能读取 choices[0].message.content,但回复不一定与“连接正常”逐字相同。只要服务返回有效对话响应,便能证明这一次请求的鉴权与模型访问链路可用;它不证明其他模型和服务都已开通。
失败后按顺序排查
- 本地提示环境变量不存在:先在运行脚本的同一终端设置变量,重新打开的终端需确认变量仍在;不要把 Key 写死到代码。
- 401 未授权:官方 HTTP 文档建议先检查 API Key。核对复制时是否缺字符、是否多了空格,以及请求头是否以
Bearer开头。 - 429 请求过于频繁:按官方文档降低频率并使用有上限的重试;不要无限重发。
- 其他错误:记录状态码与不含凭证的错误信息,核对模型权限、额度和官方错误码;不要把所有失败都归因于 Key 无效。
若怀疑 Key 泄露,应在控制台按当前可用操作撤销或轮换,并更新实际使用它的程序。本文依据 2026 年 10 月 1 日的官方快速开始与 HTTP 文档写成,未访问你的账号或发起真实鉴权请求;控制台界面、模型与计费以当期官方页面为准。
Ai菜鸟网。发布者:AI小管家,转载请注明出处:https://www.alyyhw.com/30954.html