模型 API
创建和管理 API Key
选择最小授权范围,只在服务端保存一次性展示的密钥。
在 Portal 创建
进入 模型广场 → API Key,点击“新建 API Key”。该入口需要登录,且账户满足平台当前准入要求。
- 填写用途明确的名称,例如“服务端测试”。
- 选择“平台内置服务集”或“单服务”。集合会随平台允许调用的服务变化;需固定最小授权时选择单服务。
- 按需设置到期时间。
- 创建成功后,在当前弹窗复制完整密钥并保存在服务端 secret 中,然后关闭弹窗。
完整 Key 只展示这一次。列表中的前缀只用于识别,不能用于调用,也不能恢复完整 Key。不要截图、写入源码、浏览器存储或公开日志。
管理生命周期
列表支持分页和状态筛选,展示当前用户的密钥。冻结状态应联系平台支持,不能自行解冻。删除会永久停止后续调用,历史记录保留;不会承诺取消正在运行的任务。
密钥泄漏时立即删除,重新创建最小范围的 Key,再更新服务端配置。不要用重命名或隐藏前缀代替停用。
创建结果不确定
如果提交后连接中断,服务端可能已经创建成功。不要连续重试创建:先刷新列表查找刚才的名称和时间;即使存在,也不能从列表找回秘密。删除这次不可用的 Key 后再明确创建一次。
与应用 SDK 凭据区分
| 凭据 | 用途 | 不应当用于 |
|---|---|---|
| 模型 API Key | 外部程序通过公开模型 API 调用 | 安装 SDK、替代应用用户会话 |
| 短期安装凭据 | 从受控索引下载 SDK / CLI | 模型调用、应用运行 |
| CLI 调试授权 | 为特定应用和候选版本测试真实能力 | 正式多用户运行 |
| RuntimeSession | 托管应用当前用户的运行身份 | 其他用户或其他应用的请求 |
下一步:完成首个模型调用。