上传 Checkpoint

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

这个命令会做什么

• 读取本地 .tar.gz checkpoint 归档
• 直接上传到 POST /api/v1/checkpoints/upload
• 返回一个 server-side checkpoint 路径，后续可直接用于恢复训练

目前这个流程在文档里按“直接 HTTP 上传”来定位，而不是高层 MinT SDK helper。quickstart 脚本内部使用了标准库 multipart 实现，因此不依赖额外包。

按所在区域选择 MinT 域名：

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

命令

export MINT_API_KEY=sk-...
python advanced/checkpoint.py upload ./ckpts/my-ckpt-state.tar.gz

可选参数：

• --timeout：上传超时时间（秒）

核心请求形态

POST /api/v1/checkpoints/upload
Content-Type: multipart/form-data
file=<checkpoint archive>

你也可以用任意标准 multipart HTTP 客户端发送这个请求。advanced/checkpoint.py 已经把健壮实现收敛好了，并会直接打印返回的 checkpoint 路径。

预期输出

[upload] archive=./ckpts/my-ckpt-state.tar.gz server=<your-region-endpoint>
[upload] uploaded: ckpt_...

常见失败

• 归档路径不存在
• 文件不是 .tar.gz
• API key 没有上传权限
• 请求超过 --timeout

相关页面

• 先生成 checkpoint：Save
• 下载 server-side checkpoint 归档：Download
• 从上传后的 checkpoint 路径恢复训练：Resume