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