配置与管理 API Key

MinT 用 sk- 开头的 API Key 作为客户端身份凭证。企业版走对接会议获取，配置方式与社区版一致。

申请 API Key

企业版账号通过对接会议开通，管理员会在企业账号中分配工作空间与算力配额；Key 从 macaron.im/mindlab/mint 领取。如尚未获得邀请，可联系销售：sales@mindlab.ltd。

配置环境变量

拿到 sk- 开头的 Key 后，将其写入环境变量。中国大陆区域请使用 mint-cn 端点：

export MINT_API_KEY=sk-your-api-key-here
export MINT_BASE_URL=https://mint.macaron.xin/   # 大陆区: https://mint-cn.macaron.xin/
export TINKER_BASE_URL=$MINT_BASE_URL
export TINKER_API_KEY=$MINT_API_KEY

.env 自动加载

项目根目录下的 .env 文件也会被自动加载，方便在团队内部分发配置。示例：

# .env
MINT_API_KEY=sk-your-api-key-here
MINT_BASE_URL=https://mint.macaron.xin/
TINKER_BASE_URL=https://mint.macaron.xin/
TINKER_API_KEY=sk-your-api-key-here

请把 .env 加入 .gitignore，避免 Key 进入版本控制。

验证配置

python -c "import mint; print(mint.ServiceClient._require_api_key)"

如果 _require_api_key 报错或预检超时，请检查 MINT_API_KEY 与 MINT_BASE_URL 是否正确导出，以及 mint.macaron.xin / mint-cn.macaron.xin 是否可达。

权限管理与审计

企业版提供基于工作空间的 RBAC 模型，可对训练任务、数据集、模型权重单独授权。每次 API 调用与控制台操作均落审计库，保留周期可配置（最长可至 1 年）。

私有化部署下的凭证

明确私有化交付"可选国密、SSO、AD 集成与日志外发"。具体协议与集成路径在 onboarding 阶段由 Mind Lab 方案团队与客户 IT 协商，随集群一并部署。