服务商
智谱 · 开放平台 (中国)
Agent 怎样通过 KeyKeeper 拿到 智谱 · 开放平台 (中国) 的 key,在 bigmodel.cn 该选什么,KeyKeeper 怎么验证。
| 模板 id | zhipu-cn(别名 zhipu、bigmodel、glm、智谱、zhipu-ai) |
|---|---|
| 字段 | zai-api-key → ZAI_API_KEY / ZHIPUAI_API_KEY · 密钥 |
| key 长什么样 | 能否再次查看未确认 |
| 创建页面 | bigmodel.cn |
| KeyKeeper 的验证 | 不验证 |
| 模板核实日期 | 2026-09-15 |
Agent 做什么
keykeeper providers show zhipu-cn
keykeeper save --provider zhipu-cn --from-clipboard --create --purpose "这个任务是做什么的"
keykeeper run -c zhipu-cn -- <你的命令>--provider zhipu-cn 会补上凭据 ID 和字段名。这些环境变量就是 智谱 · Z.AI 自家工具读的那个,不需要任何映射。
只有你能做的
Sign in to the China Zhipu Open Platform
Create a general API key
Activate pay-as-you-go billing or an API usage bundle if needed
复制 key,然后在 KeyKeeper 的窗口里确认保存。
该选什么
中国通用 API 使用 https://open.bigmodel.cn/api/paas/v4,按开放平台合同计费。Coding Plan 使用专用 endpoint 和套餐授权,不能按通用 API 路径假定扣套餐额度。每个项目单独建 key,保留独立撤销能力。
Agent 被告知的是同一件事。它替你打开页面、说明该选什么;它从不替你登录、过 2FA 或付费。
KeyKeeper 检查什么
- 写入前: 值必须像一把 智谱 · 开放平台 (中国) 的 key(没有形状规则)。贴错了会在存入之前被拒绝,并告诉 Agent 原因——不含值。
- 保存后: 智谱 · 开放平台 (中国) 没有 KeyKeeper 可用的只读接口,第一次真实调用就是测试。
接入地址
这把 key 是下面这些地址的 bearer token。keykeeper run 只设置上面的环境变量,base URL 要你自己在客户端里指。
- OpenAI Chat Completions——
https://open.bigmodel.cn/api/paas/v4(China)
轮换与过期
No universal expiry policy was confirmed for this credential type. Record the date shown by the provider, or leave it unknown. 在 bigmodel.cn 轮换或撤销。