API 密钥管理

API 密钥可让您直接对 MOASIS API 进行身份验证，而无需通过网页登录流程。您可以在 设置 → API 密钥 中创建和管理密钥。

创建 API 密钥

1. 打开 设置 → API 密钥，点击 + 新建密钥。
2. 为密钥填写一个便于识别的 名称（例如 "My Integration"）。
3. 选择该密钥应具有的 作用域（Scopes）：
   • READ — 读取您的内容和对话。
   • WRITE — 创建或修改内容、对话等。
   • CHAT — 使用 文本引导动作生成 API 提交提示词并获取生成结果。
4. 可选填写 过期时间。留空表示该密钥永久有效。
5. 点击 创建密钥。

新密钥的原始值仅会在创建后 显示一次。请立即复制并妥善保存（例如保存到密钥管理工具或 .env 文件中）——MOASIS 仅存储密钥的哈希值，之后无法再次显示原始密钥。如果遗失，请撤销该密钥并重新创建一个。

在 API 请求的 Authorization 请求头中使用该密钥：

Authorization: Bearer sk-<your-api-key>

管理 API 密钥

API 密钥列表会展示每个密钥的名称、密钥前缀、作用域、请求次数以及最后使用时间。

• 重命名密钥 — 将鼠标悬停在名称上并点击铅笔图标，编辑名称后按 Enter（或点击勾选图标）保存。
• 创建后无法修改作用域和原始密钥值——如需不同的作用域，请创建一个新密钥。

删除 API 密钥

1. 在列表中找到要移除的密钥，点击右侧的垃圾桶图标。
2. 在弹出的对话框中确认撤销操作。

撤销密钥会立即生效——仍在使用该密钥的集成将立即开始收到 401 Unauthorized 响应。此操作无法撤销。