快速开始
API Key 创建与配置:地址、模型 ID 和密钥怎么填
说明如何创建九维 AI 密钥、设置模型白名单与 RPM,并区分 API Base URL、完整请求地址和模型 ID。
API Key 与登录密码有什么区别#
API Key 用于桌面工具和程序调用,不是网站登录密码,也不是其他模型供应商的密钥。网页 Playground 使用登录会话,不要求额外填写 API Key。
创建一把专用密钥#
- 登录控制台的 API 密钥页面,点击“创建密钥”。
- 使用容易识别的名称,例如“WorkBuddy 日常写作”或“开发测试”。
- 按需填写允许模型;留空不扩大账户权限,密钥仍受账户资源授权限制。
- 按需设置每分钟请求数,避免一个工具占满调用额度。
- 保存创建时显示的完整密钥。关闭后无法重新查看明文;遗失时撤销旧密钥并创建新密钥。
三个关键配置值#
| 字段 | 应填写的内容 | 常见误填 |
|---|---|---|
| API Key | 创建时获得的完整 sk-ar-... | 登录密码、截断的前缀 |
| API Base URL | https://9weisc.cn/v1 | 控制台页面地址 |
| Model ID | 模型列表中的精确 id | 展示名称、品牌名 |
如果工具要求完整 Chat Completions 地址,应填写 https://9weisc.cn/v1/chat/completions。如果字段叫 API Host 且自动补路径,例如 Cherry Studio,通常填写站点根地址 https://9weisc.cn。按对应工具教程决定,不要在多个位置重复追加 /v1。
设置模型白名单#
白名单使用实际模型 ID,以英文逗号分隔。模型列表或规格发生变化时,先在账户模型中心核对,再修改工具选项;原密钥的白名单可能仍阻止新模型调用。
账户授权与密钥白名单是两层限制:管理员分配的资源决定账户可用范围,API Key 可以进一步收窄范围。创建更多密钥不会让未分配模型变为可用。
验证与撤销#
先调用只读的模型列表接口,然后执行一条短文本生成。生成请求可能产生费用,连接检测也可能包含一次模型调用。
如果密钥误发到聊天、仓库或截图,立即撤销该密钥,再更新所有使用它的工具。不要只删除那张截图而继续使用原密钥。
准备好开始了吗?
在控制台选择账户可用模型,先用一条简单请求验证配置。