> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lumi.new/llms.txt
> Use this file to discover all available pages before exploring further.

# Secrets

> 使用机密集中安全地管理您的 API 密钥。

Lumi 的 **Secrets** 功能允许您将 API 密钥存储和管理在一个地方，无论是在对话期间添加还是在工作区中手动添加。

## 添加 API 密钥

### 在对话中

您可以在对话期间直接要求添加 API 密钥。在 **Agent Mode** 下，会自动出现一个安全的输入卡，让您安全地输入您的 API 密钥。

<img src="https://mintcdn.com/blockdance/akETUyhw3LQP-hlY/images/9.png?fit=max&auto=format&n=akETUyhw3LQP-hlY&q=85&s=1b774b86855a288bc22066004fb31159" alt="9 Pn" width="1046" height="652" data-path="images/9.png" />

<Warning>
  请**不要**将您的 API 密钥直接输入到聊天消息中。请始终使用提供的安全卡。
</Warning>

### 在工作区中

您可以在工作区 - 机密中手动添加新的 API 密钥。

<img src="https://mintcdn.com/blockdance/akETUyhw3LQP-hlY/images/10.png?fit=max&auto=format&n=akETUyhw3LQP-hlY&q=85&s=0c10bd5143aeb3a8ab803e1e4e6175c1" alt="10 Pn" width="1280" height="655" data-path="images/10.png" />

* 每个密钥都必须有一个**唯一的名称**。如果您尝试使用与现有密钥相同的名称添加新密钥，则新密钥将**替换**旧密钥。
* 可以保存多个 API 密钥，从而可以在不同场景中灵活使用。

<Note>
  只允许使用字母、下划线 (`_`)、连字符 (`-`) 和数字。名称必须包含**至少一个字母**。
</Note>

## 管理密钥

* 您可以随时在工作区 - 机密中查看所有已保存的 API 密钥。
* 当不再需要某个密钥时，您可以直接删除它，以保持您的工作区井然有序和安全。

## 调用 API

* 项目的机密面板中保存的所有 API 都可以直接在该项目中调用和使用。
* 您需要在对话期间明确指定您希望 Lumi 使用的**确切 API 名称**。