获取 API Key

API Key 是调用 ModelSite API 的唯一凭证。所有请求通过 HTTP 头携带它进行鉴权与计费。

创建 API Key

前往控制台 API Keys 页面，点击 Add API Key。

添加描述

为 Key 填写一个便于识别的描述（例如 "production-server"），然后点击 Generate Key。

立即复制保存

完整 Key 仅在创建时显示一次。请立即复制并妥善保管，列表中之后只会显示掩码版本。

使用 API Key

把 Key 放进环境变量，避免硬编码到源码里：

export MODELSITE_API_KEY="ms_live_sk_xxxxxxxx"

管理 API Key

在 API Keys 页面你可以：

• 编辑 — 更新描述，或修改有效期
• 轮换（Rotate） — 保留 Key 的名称/ID 不变，重新生成一个新的密钥值（Key 可能泄露、但又不想让所有调用方都更新 Key ID 时用这个，而不是删了重建）
• 撤销（删除） — 永久移除（删除后不可恢复，使用该 Key 的应用会立即停止工作）

有效期

默认情况下 Key 没有有效期限制，直到你手动撤销为止——但创建或编辑时也可以设置有效期（7 / 30 / 90 / 180 天，或自定义日期）。如果请求突然开始报 401，先去控制台确认一下 Key 是不是过期了。

→ 下一步：安装 SDK，或直接看你的第一次调用。