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