跳到正文
九维AI开放平台使用文档

快速开始

API Key 创建与配置:地址、模型 ID 和密钥怎么填

说明如何创建九维 AI 密钥、设置模型白名单与 RPM,并区分 API Base URL、完整请求地址和模型 ID。

成都九维数创科技有限公司 · 文档团队更新于 约 5 分钟阅读
本页目录
  1. API Key 与登录密码有什么区别
  2. 创建一把专用密钥
  3. 三个关键配置值
  4. 设置模型白名单
  5. 验证与撤销

API Key 与登录密码有什么区别#

API Key 用于桌面工具和程序调用,不是网站登录密码,也不是其他模型供应商的密钥。网页 Playground 使用登录会话,不要求额外填写 API Key。

创建一把专用密钥#

  1. 登录控制台的 API 密钥页面,点击“创建密钥”。
  2. 使用容易识别的名称,例如“WorkBuddy 日常写作”或“开发测试”。
  3. 按需填写允许模型;留空不扩大账户权限,密钥仍受账户资源授权限制。
  4. 按需设置每分钟请求数,避免一个工具占满调用额度。
  5. 保存创建时显示的完整密钥。关闭后无法重新查看明文;遗失时撤销旧密钥并创建新密钥。

三个关键配置值#

字段应填写的内容常见误填
API Key创建时获得的完整 sk-ar-...登录密码、截断的前缀
API Base URLhttps://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 可以进一步收窄范围。创建更多密钥不会让未分配模型变为可用。

验证与撤销#

先调用只读的模型列表接口,然后执行一条短文本生成。生成请求可能产生费用,连接检测也可能包含一次模型调用。

如果密钥误发到聊天、仓库或截图,立即撤销该密钥,再更新所有使用它的工具。不要只删除那张截图而继续使用原密钥。

准备好开始了吗?

在控制台选择账户可用模型,先用一条简单请求验证配置。

打开 Playground