配置 MinT
可用环境变量
MinT 客户端 SDK 支持一组环境变量，用于配置端点与鉴权。以下清单严格对应 SDK 明确支持的变量。
连接与鉴权
| 变量 | 说明 | 示例 |
|---|---|---|
MINT_API_KEY | 企业版 API Key，sk- 开头。 | sk-your-api-key-here |
MINT_BASE_URL | MinT 端点，末尾保留 /。 | https://mint.macaron.xin/ 或 https://mint-cn.macaron.xin/ |
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。
大陆区端点
明确写明："中国大陆区域请使用 mint-cn 端点"：
export MINT_BASE_URL=https://mint-cn.macaron.xin/配置错误的常见症状
如果 _require_api_key 报错或预检超时，检查：
MINT_API_KEY与MINT_BASE_URL是否正确导出。- 端点
mint.macaron.xin/mint-cn.macaron.xin（或企业租户端点）是否可达。
说明
本页只列 SDK 明确定义的变量。SDK 内部还有其他可选变量，但只在特殊场景使用，请通过对接技术接口人确认后再启用，避免依赖未文档化的行为。