Create Training Job

User-friendly name for the trained model

HuggingFace model identifier (e.g. 'fastino/gliner2-base-v1', 'deepseek-ai/DeepSeek-V4-Flash', or 'nvidia/NVIDIA-Nemotron-3.5-Lightning-30B-A3B-BF16').

Training type: 'full' or 'lora'

Fraction of data held out for validation.

Maximum training epochs. With early stopping enabled, training typically terminates well before this ceiling.

Peak learning rate for AdamW. When omitted, the trainer's default applies — the per-model catalog rate (2e-4) for decoder LoRA on Modal, 2e-5 elsewhere. Pinning the old 2e-5 default on a decoder LoRA run under-trains the adapter by an order of magnitude.

Training batch size. Prefer omitting this field so the training service applies the catalog default for base_model. Explicit values equal to this Field default (4) that exceed the model's safe maximum are treated as legacy unset clients and clamped to the catalog default at the training service boundary; any other oversize value is rejected.

Optional reproducibility seed for Modal decoder training. Requests must pin provider_name to 'modal'; Fireworks and non-decoder training reject this field. When omitted, the established Modal worker default (3407) is used.

Save checkpoint every N steps

Enable structured training profiling for this run and persist a training_profile.json artifact.

Optional W&B API key for logging

Project ID to associate with this training job. When omitted, the job is anchored to the caller's auto-managed "Default" project so it is always deployable and fleet-eligible.

LoRA rank. When omitted, the trainer's default applies: the per-model catalog rank for decoder LoRA on Modal (including 32 for the qualified Nemotron 3.5 Lightning profile), or 16 elsewhere.

LoRA alpha. When omitted, the trainer's default applies: the per-model catalog alpha for decoder LoRA on Modal, or 32 elsewhere.

LoRA dropout. When omitted, the trainer's default applies: the per-model catalog dropout for decoder LoRA on Modal, or 0.1 elsewhere.

Decoder SFT loss masking knob. Dense decoder LoRA currently rejects true until assistant-only loss masking is supported by the active trainer. Defaults false to preserve the stock recipe.

Fraction of total training steps for linear LR warmup. Ignored when warmup_steps is set. When omitted, the trainer's default applies — the per-model catalog warmup (0.03) for decoder LoRA on Modal, none elsewhere.

Absolute number of linear LR warmup steps. When set, takes priority over warmup_ratio.

LR decay schedule after warmup: 'constant', 'linear', or 'cosine'.

AdamW weight decay (L2 penalty). 0 disables weight decay. Honoured by Modal decoder/dense-LoRA training paths. Not forwarded to GLiNER2 Modal training, which uses its own container default.

Validation epochs without improvement before stopping. Requires validation_data_percentage > 0. Set to 0 to disable.

Minimum validation loss improvement to count as progress. Prevents early stopping from triggering on noise.

Pin training to a specific provider (e.g. 'modal'). Bypasses automatic provider selection.

Canonical system prompt written to every decoder training row. When populated, it is persisted on training_jobs.system_prompt and re-injected by inference providers for API-direct callers that omit the system message (train/serve alignment), and prefills the inference-page system-prompt editor. Leave null for PAFT datasets, mixed-prompt uploads, or any case where no single prompt should be pinned at serve time. Ignored for non-decoder tasks.

GLiNER only: learning rate applied to encoder parameters. When omitted, falls back to learning_rate.

GLiNER only: learning rate applied to task-head parameters. When omitted, falls back to learning_rate.

Accumulate gradients over N mini-batches before each optimizer step. Effective batch size = batch_size * N. Honoured by GLiNER and dense decoder LoRA training; when omitted, dense LoRA applies the per-model catalog default (8 for the H200 Nemotron 3.5 profiles, whose per-device batch is pinned to 1).

GLiNER only. Opt-in: when true, downsample each training dataset to min(max_samples_per_dataset, max(min_samples_per_dataset, samples_per_label * num_labels)). When omitted or false, the full provided dataset is used (no silent downsampling). Defaults to false in the Modal container.

GLiNER only: lower bound for auto-sized dataset cap.

GLiNER only: upper bound for auto-sized dataset cap.

GLiNER only: scaling factor used when computing the auto-sized per-dataset cap.

GLiNER only: minimum number of optimizer steps; raises epoch count if the provided nr_epochs would yield fewer steps.

Training algorithm: 'sft' (default), 'grpo', or 'dpo'. GRPO and DPO are dispatched to the Modal RL entrypoint. GRPO requires rl_config.reward_type from the built-in menu; DPO requires {prompt, chosen, rejected} columns and optional rl_config.dpo_beta / loss_type.

Project ID this training job is associated with

Effective reproducibility seed for Modal decoder training. Null for Fireworks, unknown, and other providers that cannot honor this contract.

Canonical status alias for compatibility handling (requested, running, complete, deployed, failed, cancelled)

Whether this status is terminal for polling loops

Task type derived from training datasets: 'ner', 'classification', 'custom', or 'decoder'

Raw training method as persisted: 'lora', 'qlora', or 'full'.

Normalized fine-tune kind: 'lora' for adapters (lora/qlora) or 'full' for merged weights. Null when the persisted training type is unrecognised -- clients must not claim a kind in that case.

Whether an artifact location is recorded, so there is something to serve.

Whether a provider is already serving this artifact. False is not a deployment blocker: promotion provisions or re-warms a provider.

Whether this job passes server-side deployability validation for its own project. Authoritative -- the same check the deployment endpoints enforce.

Why the job is not deployable (e.g. 'job_incomplete', 'missing_artifact', 'provider_incompatible'). Null when deployable.

Sample text to pre-load into inference input

Version number for this training job (e.g., '1', '2', '3')

ID of the original/root training job this version derives from

Training provider that handled this job (e.g. 'modal'). Jobs predating a provider removal carry an 'archived_<provider>' label.

Overall training completion percentage (0-100). Updated live during training.

Epoch currently in progress (1-indexed). Updated live during training.

Deprecated. Always returns None -- deployment_status no longer exists.

Kept for backward compat with clients that read this field.