Create a training run
Send inputSetId, estimateFingerprint, versionName, and an Idempotency-Key header. The platform checks the estimate again and returns the training run. Returns 409 if the estimate changed, the input set is in use, the version name exists, or the key was used for different input.
Authorizations
Enter ApiKey <your-api-key> in Authorization, including the ApiKey prefix. In cURL and Python samples, <api-key> means this full value. The TypeScript SDK adds the prefix for you.
Headers
A caller-generated key reused for retries of one logical request.
1 - 128Path Parameters
Training draft ID with prefix trg..
^trg\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Body
Fingerprint from a ready cost estimate, as 64 lowercase hexadecimal characters.
^[0-9a-f]{64}$Prepared input set ID with prefix tei. used for the accepted estimate.
^tei\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Name to reserve for the output model version.
1 - 120Response
Queued Training Run
The configuration, inputs, and current state of one training run.
Billing state: pending before reservation, reserved while funds are held, release_pending or released for returned funds, settled after charging, payment_required for a shortfall, resolved after staff review, or reconciliation_required when charges need review.
pending, reserved, release_pending, released, settled, payment_required, resolved, reconciliation_required Reason the run is blocked: funds to reserve the budget, payment to settle usage, or billing_review for staff review; otherwise null.
funds, payment, billing_review Settled charge in US dollars as a decimal string, or null before a charge is recorded.
^(0|[1-9][0-9]*)(\.[0-9]+)?$A normalized method-specific Training draft.
- Option 1
- Option 2
Time the training run was created, as an ISO 8601 timestamp.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Failure or cancellation details, or null when no error is recorded.
SHA-256 fingerprint of the accepted estimate, as 64 lowercase hexadecimal characters.
^[0-9a-f]{64}$The immutable input set used to calculate a Training Cost Estimate.
^tei\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$ID of the training run, with prefix trn..
^trn\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Cutoff used to freeze the input rows, as an ISO 8601 timestamp.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$Prepared training and validation inputs; null when unavailable or omitted from create and list responses.
Maximum accepted charge for this run, in US dollars as a decimal string.
Current status or billing explanation, or null when none is available.
Model version ID with prefix mdv..
^mdv\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Name reserved for the model version this run produces.
1 - 120Published model version revision, or null before publication.
0 < x <= 9007199254740991Latest training progress while running or stopping; null in other states or when progress is unavailable.
Cost estimate accepted for this run.
Run state: queued, running, stopping, blocked, completed, failed, or canceled; blocked requires resolving the reported reason.
queued, running, stopping, blocked, completed, failed, canceled Training draft ID with prefix trg..
^trg\.[0-9a-f]{8}-[0-9a-f]{4}-[7][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$Time the training run was last updated, as an ISO 8601 timestamp.
^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$