第 12 课,共 12 课

API、Webhook 与自动化

一切都可以走 REST 完成——不需要界面。带 Webhook 的异步任务示例:

curl -X POST http://127.0.0.1:8653/api/jobs \
  -H "X-TT-Token: $TT_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"model":{"custom":"HuggingFaceTB/SmolLM2-135M-Instruct"},
       "dataset_id":"<dataset-id>",
       "lora":{"r":16,"alpha":32},
       "params":{"lr":2e-4,"epochs":3,"bs":2,"gacc":1},
       "webhook":"https://example.com/hook"}'
  • POST /api/jobs 创建异步任务并返回监控地址;GET /api/jobs/<id> 提供实时状态。
  • 完成时,服务器向你的 Webhook 发送带 X-TT-Signature: sha256=HMAC(body) 签名的 POST——在接收端用同一密钥验证消息完整性。
  • 自定义 Webhook 头会被清洗,私有/内网目标(SSRF)被拦截——除非设置 TT_WEBHOOK_ALLOW_PRIVATE=1 用于纯本地自动化。
  • 队列弹窗显示每个任务的 Webhook 列:送达 ✓ 或失败 ✗。
带 Webhook 列的队列
提示:完整的 API 地图在同目录的 INSTALL.md 里。
课程目录 · 第 12 课,共 12 课
TheTensorTune workbench