创建用于编程访问 Entity Enricher 的 API 密钥。为服务间集成、CI/CD 流水线和自动化工作流使用组织访问密钥。
Entity Enricher 支持两种类型的 API 密钥，各自适用于不同的使用场景：
拥有独立角色的独立密钥，不绑定任何用户账户。是服务间集成的最佳选择。
与特定用户账户绑定的密钥。它们会继承创建者的角色，并受用户账户变更的影响。
ent_a1b2c3d4e5f6g7h8密钥使用 ent_ 前缀，后跟随机字节。完整密钥在创建时仅显示一次——之后无法再取回。
访问密钥（用于调用 Entity Enricher 的 API）在数据库中以 SHA256 哈希形式存储，因此即使拥有数据库访问权限，也无法恢复原始密钥。仅前 12 个字符（前缀）以明文形式存储以供识别。
提供商密钥（如 Anthropic、OpenAI 等 LLM API 密钥）在静态存储时采用 Fernet 对称加密（AES-128-CBC + HMAC）。它们必须能在运行时解密，以便向 LLM 提供商进行身份验证。只有最后 4 个字符以明文存储。
ent_ 前缀和一个哈希值，因此当时未复制下来的密钥只能重新生成，永远无法找回。在应用的 API 密钥页面创建密钥，或通过 REST API 以编程方式创建：
| 字段 | 描述 |
|---|---|
| 名称 | 用于标识的描述性名称（例如“CI/CD Pipeline”、“n8n Integration”） |
| 角色 | 权限级别：owner、editor 或 operator。决定该密钥可以访问的内容。 |
| 范围 | 读取、写入或两者。控制该密钥是可以修改数据还是仅能读取数据。 |
| 过期 | 可选的过期日期。未设置过期时间的密钥在被撤销前一直有效。 |
在每次请求的 X-API-Key 请求头中发送你的 API 密钥：
curl -H "X-API-Key: ent_your_key_here" \
https://your-instance.example.com/api/enrichment/options| 方法 | 标头 | 用例 |
|---|---|---|
| API 密钥 | X-API-Key: ent_... | 服务间调用、CI/CD、自动化 |
| Bearer Token | Authorization: Bearer <jwt> | Web 客户端、交互式会话 |
| OAuth 2.1 | Authorization: Bearer <access_token> | 连接器与 AI 客户端 — 每个应用一项可撤销的授权，而非共享密钥 |
API 密钥的角色决定了它可以访问哪些端点：
| 端点类别 | 最低角色 |
|---|---|
| 丰富化（单个、批量） | 运算符 |
| 记录（列表、详情、删除） | 运算符 |
| Schema（读取） | 运算符 |
| Schema（创建、编辑、删除） | 编辑器 |
| 融合 | 运算符 |
| 提供商信息 | 运算符 |
| 成本分析 | 运算符 |
| API 密钥管理 | 所有者 |
| 用户管理 | 所有者 |
API 密钥页面提供所有组织密钥的完整视图及使用统计：
API 密钥页面有五个用途各异的选项卡——其中四个面向所有人，另加面向系统管理员的“全局密钥”：
你所在组织的 LLM 提供商 API 密钥（Anthropic、OpenAI 等），用于独立计费。支持为每个提供商配置多个密钥并自动 LRU 轮换；测试失败的密钥会退出轮换，直到重新测试或被替换。BYOK 体系详见模型与定价。
提供商密钥使用 Fernet 对称加密（带 HMAC 认证的 AES-128-CBC）进行静态加密。仅在进行 LLM API 调用时于运行时解密。仅最后 4 个字符以明文存储用于显示。
由管理员管理的系统级 LLM 提供商密钥。当组织没有可用密钥时作为后备使用。支持每个提供商配置多个密钥并按 LRU 轮换：最久未使用的已启用密钥将被下一个使用；当管理员禁用某个密钥，或其测试判定为无效时，该密钥将退出轮换。若某个提供商没有可用密钥，运行将被拒绝而不会启动。
用于 Entity Enricher 自身 API 的组织访问密钥。供外部系统以编程方式调用增强、模式、记录等端点。端点文档请参见 API 参考。
你通过 OAuth 2.1 授权的应用 — claude.ai 连接器目录、Claude Desktop、Make 和 n8n 连接。每一行都是一项可撤销的授权，而非共享密钥：在此撤销会使该应用的令牌失效，而不影响你的其他集成。所有者还可为自托管的 n8n 实例注册 OAuth 客户端。
自助式 Ollama 隧道的凭据，可在不开放端口的情况下将本地 Ollama 暴露给平台。请参阅 Ollama 隧道指南。