可用环境变量¶
Mint Recursive 客户端 SDK 支持一组环境变量，用于配置端点和鉴权。下表只列 SDK 明确支持的变量。
连接与鉴权¶
| 变量 | 说明 | 示例 |
|---|---|---|
MINT_API_KEY |
企业版 API Key，sk- 开头。 |
sk-your-api-key-here |
MINT_BASE_URL |
Mint Recursive 端点，末尾保留 /。 |
https://mint.macaron.im/train 或 https://mintcn.macaron.xin/train |
TINKER_API_KEY |
tinker 兼容入口（import mint as tinker）。通常设为 $MINT_API_KEY。 |
$MINT_API_KEY |
TINKER_BASE_URL |
同上，tinker 兼容。通常设为 $MINT_BASE_URL。 |
$MINT_BASE_URL |
默认底座模型¶
| 变量 | 说明 | 示例 |
|---|---|---|
MINT_BASE_MODEL |
支持该变量的脚本（如 Cookbook）会读取它作为默认底座模型。 | Qwen/Qwen3-4B-Instruct-2507 |
.env 自动加载¶
项目根目录下的 .env 文件会被自动加载，方便在团队内部分发配置。.env 里使用和上表相同的变量名。请务必把 .env 加入 .gitignore，避免把密钥提交到代码仓库。
大陆区端点¶
中国大陆区域请使用 mintcn 端点：
配置错误的常见症状¶
如果 _require_api_key 报错或预检超时，检查以下两项：
MINT_API_KEY与MINT_BASE_URL是否正确导出。- 端点
mint.macaron.im/mintcn.macaron.xin（或你的企业租户端点）是否可达。
说明
本页只列 SDK 明确定义的变量。SDK 内部还有其他可选变量，但只在特殊场景使用。启用前请向你的技术接口人确认，避免依赖未文档化的行为。