使用指南
Tinker 兼容性路线图
本页仅列出与 Tinker 兼容性相关的接口。标注 已上线 的为已可用，标注 planning 的为尚未实现。
当前最实用的迁移规则
对普通 Tinker 风格实验，如果你要切到 MinT，最省事的方式是：
import mint as tinker然后再把 API key 和 Base URL 切到 MinT。
为什么推荐这条规则：
- 原生 upstream
import tinker仍会在本地校验tml-API key 前缀 - MinT API key 以
sk-开头 import mint as tinker可以保持 Tinker 风格代码形状，同时启用 MinT 兼容层
如果你必须保留原样的 import tinker 语句，请先在同一进程里 import mint，再构造 Tinker client。
更新时间： 2026 年 4 月 9 日
兼容性接口列表
| 接口 | 状态 | 说明 |
|---|---|---|
| create_lora_training_client（create_model） | 已上线 | 训练客户端创建 |
| forward / forward_backward / optim_step | 已上线 | 核心训练循环 |
| save_weights_for_sampler | 已上线 | 采样用权重导出 |
| create_sampling_session | 已上线 | 基于会话的采样 |
| compute_logprobs + prompt_logprobs/topk_prompt_logprobs | 已上线 | prompt logprobs 支持 |
| get_info / get_tokenizer | 已上线 | 模型信息与 tokenizer |
| save_state + TrainingClient.load_state_with_optimizer | 已上线 | 保留 optimizer 的续训使用显式 create_lora_training_client(...) + load_state_with_optimizer(...) |
| create_training_client_from_state | 已上线 | 仅加载 weights；optimizer state 会重置 |
| forward_backward_custom | 已上线 | 客户端侧自定义 loss 链路，基于 forward + forward_backward 组合实现 |
| RestClient 训练与会话接口 | planning | get_training_run / list_training_runs / get_session / list_sessions / get_sampler |
| RestClient checkpoint + 标准 tinker 路径 | planning | publish/unpublish/list_user_checkpoints + tinker://.../weights/... |
| /sampling_clients/save_and_create | planning | 保存+创建一体化端点 |
| sampling_session_seq_id / seq_id | planning | 多轮采样确定性 |
| 多轮渲染器系统 | planning | 与 Tinker cookbook renderer 对齐 |
实用验证流程
- 真实可运行的 MinT checkpoint 工作流，见 Advanced / Checkpoint。
- session-level Seq-MIS rollout-correction 验证，见 Advanced / MIS Rollout Correction。
forward_backward_custom的可运行成对偏好示例，见 Loss Functions。- MinT-only 的 OpenPI / VLA SDK 路径，见 OpenPI VLA SDK。它放在
mint.mint/mintx，不属于 Tinker-compatible 默认 namespace。 - 这条 helper 背后的 raw wire format，见 OpenPI VLA HTTP。
这些 advanced 页面记录的是 MinT 侧已经可运行的工作流；它们不代表上表之外已经具备完整 Tinker parity。