获取 API Key
在控制台创建你的第一个 ModelSite API Key
API Key 是调用 ModelSite API 的唯一凭证。所有请求通过 Authorization: Bearer <Key> 头携带它进行鉴权与计费；不接受 x-api-key 头，也不接受放在 URL 参数里的 Key。
创建 API Key
前往控制台 API Keys 页面，点击 创建新密钥。
填写名称
为 Key 填写一个便于识别的名称（控制台要求 3–64 个字符，例如 "production-server"），按需选择有效期，然后点击 创建。
立即复制保存
创建成功后会显示完整 Key，请立即复制并妥善保管。列表默认只显示掩码，新创建的 Key 之后也可以点「显示」或「复制」取回完整值；早期创建的旧版 Key 无法再取回，需要轮换（Rotate）后获得新值。
Key 格式
新 Key 以 sk-ms- 开头（后接 64 位十六进制字符）；早期以 sk-relay- 开头的旧 Key 仍然有效。格式不符的 Key 会直接返回 401。
使用 API Key
把 Key 放进环境变量，避免硬编码到源码里：
export MODELSITE_API_KEY="sk-ms-xxxxxxxx"永远不要把 API Key 提交到代码仓库或暴露在前端。Key 泄露会导致安全风险与财务损失。
管理 API Key
在 API Keys 页面你可以：
- 编辑 — 修改名称，或修改有效期
- 轮换（Rotate） — 保留 Key 的名称/ID 不变，重新生成一个新的密钥值，旧值随即失效（Key 可能泄露、但又不想让所有调用方都更新 Key ID 时用这个，而不是删了重建）
- 撤销（删除） — 点击「删除密钥」后该 Key 永久失效并从列表中消失，不可恢复，使用它的应用会停止工作
有效期
默认情况下 Key 没有有效期限制，直到你手动撤销为止——但创建或编辑时也可以设置有效期（7 / 30 / 90 / 180 天，或自定义日期）。如果请求突然开始报 401，先去控制台确认一下 Key 是不是过期了。
轮换、撤销、过期和停用都经平台的配置同步生效，通常在数秒内完成，不是同一毫秒。配置同步中断时网关会拒绝服务（503），见错误码。
限制
- Key 不能单独限定可调用的模型；要限制模型，把 Key 放进团队，并在团队上设置模型白名单（调用白名单之外的模型返回
403 model_access_error）。 - 限流（RPM / TPM）、余额与预算额度的行为见平台扩展与差异。