星海智算开发文档
模型 API

创建和管理 API Key

选择最小授权范围,只在服务端保存一次性展示的密钥。

在 Portal 创建

进入 模型广场 → API Key,点击“新建 API Key”。该入口需要登录,且账户满足平台当前准入要求。

  1. 填写用途明确的名称,例如“服务端测试”。
  2. 选择“平台内置服务集”或“单服务”。集合会随平台允许调用的服务变化;需固定最小授权时选择单服务。
  3. 按需设置到期时间。
  4. 创建成功后,在当前弹窗复制完整密钥并保存在服务端 secret 中,然后关闭弹窗。

完整 Key 只展示这一次。列表中的前缀只用于识别,不能用于调用,也不能恢复完整 Key。不要截图、写入源码、浏览器存储或公开日志。

管理生命周期

列表支持分页和状态筛选,展示当前用户的密钥。冻结状态应联系平台支持,不能自行解冻。删除会永久停止后续调用,历史记录保留;不会承诺取消正在运行的任务。

密钥泄漏时立即删除,重新创建最小范围的 Key,再更新服务端配置。不要用重命名或隐藏前缀代替停用。

创建结果不确定

如果提交后连接中断,服务端可能已经创建成功。不要连续重试创建:先刷新列表查找刚才的名称和时间;即使存在,也不能从列表找回秘密。删除这次不可用的 Key 后再明确创建一次。

与应用 SDK 凭据区分

凭据用途不应当用于
模型 API Key外部程序通过公开模型 API 调用安装 SDK、替代应用用户会话
短期安装凭据从受控索引下载 SDK / CLI模型调用、应用运行
CLI 调试授权为特定应用和候选版本测试真实能力正式多用户运行
RuntimeSession托管应用当前用户的运行身份其他用户或其他应用的请求

下一步:完成首个模型调用

本页目录