下载 Checkpoint

这一页对应 mint-quickstart 中的 advanced/checkpoint.py download。

这个命令会做什么

• 接收一个 mint://... 或 tinker://... checkpoint 路径
• 通过 MinT REST client 申请签名归档 URL
• 在 archive 仍在生成时自动重试（409）
• 将 .tar.gz 归档下载到本地目录
• 默认自动解压
• 如果签名归档 host 宣称是 HTTPS、实际却是明文 HTTP，会自动降级重试

按所在区域选择 MinT 域名：

• 境内：https://mint-cn.macaron.xin/
• 境外：https://mint.macaron.xin/

命令

export MINT_API_KEY=sk-...
python advanced/checkpoint.py download tinker://<run-id>/weights/<checkpoint-name> -o ./ckpts

常用参数：

• --checkpoint-type {auto,sampler,training}：处理没有 weights/ 或 sampler_weights/ 前缀的旧路径
• --no-extract：只保留 .tar.gz，不自动解压
• --max-wait 和 --poll-interval：调节 409 重试等待策略

核心 API

rest_client = service_client.create_rest_client()
archive = rest_client.get_checkpoint_archive_url_from_mint_path(mint_path).result()
# 必要时也会回退到 Tinker 风格 path helper，
# 然后再用标准 HTTP 客户端下载 archive.url。

quickstart 脚本在必要时还会回退到 Tinker 风格的 archive URL 方法，但这里的文档只保留最核心的 MinT 路径。

预期输出

[download] path=tinker://.../weights/my-ckpt-state type=auto out=/.../ckpts
[download] trying: mint://.../weights/my-ckpt-state
  signed URL obtained, downloading...
  signed URL rejected TLS; retrying over http for archive download...
[download] saved to: /.../ckpts/my-ckpt-state.tar.gz

常见失败

• checkpoint 路径无效或 checkpoint 不存在
• 归档生成时间超过 --max-wait
• 旧路径使用了错误的 --checkpoint-type
• 输出目录没有写权限

相关页面

• 先生成 checkpoint：Save
• 上传本地归档：Upload
• 从下载后的 checkpoint 继续训练：Resume