FAfastino-ai
training

Create an interactive training job

Changed on

Create a LoRA training job on a decoder base model that you train step by step (Tinker's create_model), or restore one from a training-state checkpoint. Encoder (GLiNER) models train from a dataset with POST /v1/training/jobs. Read the result at GET /v1/training/jobs/{job_id}/futures/{future_id}.

post/v1/training/jobs/create-model

Request

Headers

Idempotency-Keystring nullable

Client-generated key (a UUID is ideal; it must be URL-safe to look it up) that makes the call safe to send again after a lost response. A repeat with the same key and body from the same caller returns the first call's answer (the same job and future) without running or billing it again, or a 409 while the first call still runs; the same key with another route, job, body or caller is a 422. Look a key up with GET /v1/training/operations/{idempotency_key}.

Request body

base_modelstring nullable

A decoder served for training (GET /v1/base-models?supports_training=true).

from_checkpointstring nullable

A training-state checkpoint (tinker://<job_id>/weights/<name>) to start from; the job takes its base model and LoRA settings.

load_optimizerboolean

With from_checkpoint, also restore the optimizer state.

project_idstring nullable
user_metadataobject nullable

String keys and values, as on save-weights.

Response

Successful Response

base_modelstring required
future_idstring required

The job's create future.

job_idstring required
load_future_idstring nullable

With from_checkpoint: the future that loads it.

type'interactive'

Changes

  • 81465e18c1d2Revision changes
    • info

      added the new optional header request parameter Idempotency-Key

  • ef285860f952Revision changes
    • breaking

      removed from the request property anyOf list

    • info

      added subschema #1 to the request property anyOf list