跳转至

Tinker 兼容 API

Mint Recursive 可直接替代 Tinker SDK

Mint Recursive 客户端暴露的公开接口与 Tinker SDK 完全一致。 安装 Mint Recursive SDK 后，为导入的模块设置别名，以下文档中的所有类型、客户端和方法 都可以原样使用：

pip install git+https://github.com/MindLab-Research/mindlab-toolkit.git

import mint as tinker   # use tinker.ServiceClient, tinker.types.Datum, ...

设置 Mint Recursive 凭证（带 Tinker key 前缀的 key 在导入时打补丁后也能用）：

export MINT_API_KEY=sk-your-api-key-here
export MINT_BASE_URL=https://mint.macaron.im/train        # mainland China: mintcn.macaron.xin

下面的参考文档按模块列出了 SDK 中所有公开的类型和客户端。这些都是 Tinker 兼容类型，通过 import mint as tinker 或直接 import mint 调用。

  • ServiceClient —— 主入口；创建训练、采样和 REST 客户端。
  • TrainingClient —— LoRA 训练循环（forward_backward、optim_step、保存权重）。
  • SamplingClient —— token 采样与对数概率。
  • RestClient —— REST 操作（列出权重、用量查询）。
  • APIFuture —— 所有 SDK 调用返回的异步 future。
  • Types —— Datum、ModelInput、SamplingParams、AdamParams、LoRAConfig 等。
  • Exceptions —— SDK 调用抛出的错误层级。

归属说明

本节的 API 参考改编自 Tinker SDK，后者基于 Apache License, Version 2.0 授权。

  • 版权： Copyright (c) Thinking Machines Lab and contributors.
  • 许可： Apache License 2.0 —— 许可副本见 /licenses/APACHE-2.0.txt。
  • 修改： 参考文档已为 Mint Recursive 适配（重命名模块和类标识符，补充 Mint Recursive 专有的端点与凭证说明）； 底层的类型与方法签名保持不变。

以上满足 Apache 2.0 的再分发要求（保留许可副本、版权声明和修改说明）。