智谱开放平台 API Key 怎么获取并验证?创建、保管与首个鉴权请求

在智谱开放平台创建 API Key,通过最小对话请求验证鉴权,并按状态码定位常见失败和保管密钥。

智谱开放平台 API Key 是程序调用模型的凭证。获取它的正确起点是官方开发者平台,而不是清言聊天页或第三方“共享密钥”。创建后先用一个最小请求验证鉴权,再把 Key 留在本机安全位置;验证时不要把完整 Key 打印、截图或贴进问题帖。

从官方控制台创建 Key

智谱快速开始说明:进入开放平台完成注册登录,在个人中心的 API Keys 页面创建新 Key。不同账号可能还需按页面提示完成认证、额度或项目设置;以登录后的实际界面为准。新建后复制到密码管理器或本机环境变量,勿放入网页前端、公开仓库或共享文档。

智谱开放平台 API 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

赞 (0)
AI小管家的头像AI小管家
智谱 Web Search API 怎么用?获取搜索结果并核查来源与日期
上一篇 1天前
ChatGPT 记忆已满怎么办?清理已保存记忆并保留重要信息
下一篇 1天前

相关推荐

联系我们

联系我们

1

在线咨询: QQ交谈

邮件:admin@example.com

工作时间:周一至周五,9:30-18:30,节假日休息

关注微信
关注微信
分享本页
返回顶部