همه‌ی کارها از طریق REST API هم قابل انجام‌اند — بدون رابط گرافیکی. نمونه‌ی job آسنکرون با وب‌هوک:

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 job آسنکرون می‌سازد و آدرس نظارت را برمی‌گرداند؛ GET /api/jobs/<id> وضعیت زنده می‌دهد.
در پایان، سرور به وب‌هوک شما POST می‌زند با امضای X-TT-Signature: sha256=HMAC(body) — صحت پیام را در مقصد با همان کلید بررسی کنید.
هدرهای سفارشی وب‌هوک پاک‌سازی می‌شوند و مقاصد داخلی/خصوصی (SSRF) بلاک‌اند — مگر با TT_WEBHOOK_ALLOW_PRIVATE=1 برای اتوماسیون کاملاً محلی.
مودال صف ستون وب‌هوک هر job را نشان می‌دهد: ارسال‌شده ✓ یا خطا ✗.

نکته: نقشه‌ی کامل API را در راهنمای نصب (INSTALL.md) کنار همین فایل ببینید.

فهرست دوره · درس 12 از ۱۲

API، وب‌هوک و اتوماسیون