client.trainings.estimateCost()

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const estimate = await client.trainings.estimateCost({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  inputSetId: "tei.019a0000-0000-7000-8000-000000000001"
});
console.log(estimate);

{
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "inputSetId": "tei.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "inputs": {
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "datasetExportId": "dex.019a0000-0000-7000-8000-000000000001",
      "report": null,
      "failure": null
    },
    "validation": null
  },
  "capabilityVersion": "<string>",
  "pricingVersion": "<string>",
  "calculatedAt": "2026-01-01T00:00:00Z",
  "status": "blocked",
  "issues": [
    {
      "code": "unsupported_source",
      "message": "<string>",
      "purpose": null
    }
  ]
}

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const estimate = await client.trainings.estimateCost({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  inputSetId: "tei.019a0000-0000-7000-8000-000000000001"
});
console.log(estimate);

{
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "inputSetId": "tei.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "inputs": {
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "datasetExportId": "dex.019a0000-0000-7000-8000-000000000001",
      "report": null,
      "failure": null
    },
    "validation": null
  },
  "capabilityVersion": "<string>",
  "pricingVersion": "<string>",
  "calculatedAt": "2026-01-01T00:00:00Z",
  "status": "blocked",
  "issues": [
    {
      "code": "unsupported_source",
      "message": "<string>",
      "purpose": null
    }
  ]
}

Send the prepared inputSetId. Returns either a maximum charge and fingerprint for starting a run, or issues that block training. Returns 409 while inputs are still being prepared or after they expire.

Signature

Method signature on client.trainings:

estimateCost(args: {
  trainingId: string;
  inputSetId: string;
}): Promise<TrainingCostEstimate>;

Parameters

string

required

Training draft ID with prefix trg..

string

required

The immutable input set used to calculate a Training Cost Estimate.

Returns

Promise<TrainingCostEstimate> A validation result and conservative maximum price for one Training draft.

TrainingId

required

Training draft ID with prefix trg..

TrainingCostEstimateInputSetId

required

The immutable input set used to calculate a Training Cost Estimate.

string

required

Dataset cutoff used to select the inputs, as an ISO 8601 timestamp.

TrainingCostEstimateInputs

required

Prepared inputs and their validation reports.

Show Fields

object

required

Frozen training selection and its validation result.

Show Fields

string

required

Dataset ID with prefix ds. containing these examples.

string

required

Export ID with prefix dex. for the frozen selection.

TrainingInputReport | null

required

Validation report for these examples, or null when the export failed or produced no report.See the HTTP endpoint for the complete schema.

TrainingInputExportFailure

required

Export failure details, or null when the export did not fail.See the HTTP endpoint for the complete schema.

number

Number of rows excluded by split roles; absent when that count has not been calculated.

object | null

required

Frozen validation selection and its validation result, or null when no validation input is selected.

Show Fields

string

required

Dataset ID with prefix ds. containing these examples.

string

required

Export ID with prefix dex. for the frozen selection.

TrainingInputReport | null

required

Validation report for these examples, or null when the export failed or produced no report.See the HTTP endpoint for the complete schema.

TrainingInputExportFailure

required

Export failure details, or null when the export did not fail.See the HTTP endpoint for the complete schema.

number

Number of rows excluded by split roles; absent when that count has not been calculated.

string

required

Version of the model capability rules used for this estimate.

string

required

Version of the pricing rules used for this estimate.

string

required

Time the estimate was calculated, as an ISO 8601 timestamp.

"blocked" | "ready"

required

Estimate status; blocked means the reported issues must be resolved before starting a run. Estimate status; ready means the inputs passed validation and a maximum charge is available.

TrainingCostEstimateIssue[]

required

Issues preventing a ready cost estimate. Blocking issues; always empty for a ready estimate.

Show Variant 1

TrainingCostEstimateIssue

required

Show Fields

required

Reason the estimate is blocked: unsupported source or duration, failed export, invalid or empty examples, exceeded row or token limits, or a mismatched token estimator.

string

required

Explanation of the issue preventing a ready estimate.

"training" | "validation" | null

required

Affected input: training or validation, or null when the issue applies to the whole estimate.

Show Variant 2

TrainingCostEstimateIssue

required

Show Fields

required

Reason the estimate is blocked: unsupported source or duration, failed export, invalid or empty examples, exceeded row or token limits, or a mismatched token estimator.

string

required

Explanation of the issue preventing a ready estimate.

"training" | "validation" | null

required

Affected input: training or validation, or null when the issue applies to the whole estimate.

TrainingResourceBudget

Estimated and maximum training resource usage.

Show Fields

number

required

Token-based work estimate, including epochs and the method-specific training and validation workload.

number

required

Estimated total GPU time, in seconds summed across all GPUs.

number

required

Estimated elapsed training time, in seconds.

number

required

Conservative maximum elapsed training time, in seconds.

number

required

Maximum GPU time used to bound the charge, in seconds summed across all GPUs.

number

required

Number of GPUs used for the estimate.

string

Maximum charge in US dollars as a decimal string.

"USD"

Currency used for the estimate; always USD.

string

SHA-256 fingerprint of this estimate, as 64 lowercase hexadecimal characters; send it when starting the run.

Errors

HTTP errors throw PotatoApiError. The endpoint documents these error responses:

Status	Description
409	Expired Input Set or inputs still running
429	Rate limit exceeded

HTTP endpoint: POST /trainings/{trainingId}/cost-estimate.

import { createClient } from "@toloka-platform/sdk";

const client = createClient({
  baseUrl: "https://platform.toloka.ai",
  apiKey: process.env.TOLOKA_API_KEY!,
});

const estimate = await client.trainings.estimateCost({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  inputSetId: "tei.019a0000-0000-7000-8000-000000000001"
});
console.log(estimate);

{
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "inputSetId": "tei.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "inputs": {
    "training": {
      "datasetId": "ds.019a0000-0000-7000-8000-000000000001",
      "datasetExportId": "dex.019a0000-0000-7000-8000-000000000001",
      "report": null,
      "failure": null
    },
    "validation": null
  },
  "capabilityVersion": "<string>",
  "pricingVersion": "<string>",
  "calculatedAt": "2026-01-01T00:00:00Z",
  "status": "blocked",
  "issues": [
    {
      "code": "unsupported_source",
      "message": "<string>",
      "purpose": null
    }
  ]
}

Reference

TypeScript SDK

CLI

HTTP API

client.trainings.estimateCost()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors