client.trainings.prepareCostEstimateInputs()

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

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

const inputSet = await client.trainings.prepareCostEstimateInputs({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  idempotencyKey: crypto.randomUUID()
});
console.log(inputSet);

{
  "id": "tei.019a0000-0000-7000-8000-000000000001",
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "expiresAt": "2026-01-01T00:00:00Z",
  "exports": {
    "training": "dex.019a0000-0000-7000-8000-000000000001",
    "validation": null
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

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

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

const inputSet = await client.trainings.prepareCostEstimateInputs({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  idempotencyKey: crypto.randomUUID()
});
console.log(inputSet);

{
  "id": "tei.019a0000-0000-7000-8000-000000000001",
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "expiresAt": "2026-01-01T00:00:00Z",
  "exports": {
    "training": "dex.019a0000-0000-7000-8000-000000000001",
    "validation": null
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

Send an Idempotency-Key header and an empty JSON body to freeze training and validation inputs for the current configuration. Poll each non-null ID in exports with GET /api/v2-beta/exports/{exportId} until its status is succeeded or failed. A failed export blocks the estimate with an export_failed issue. Once all exports succeed, send the input set’s id as inputSetId to POST /api/v2-beta/trainings/{trainingId}/cost-estimate before expiresAt. Test rows are excluded, except validation rows in a part with both validate and test roles in the selected split field.

Signature

Method signature on client.trainings:

prepareCostEstimateInputs(args: {
  trainingId: string;
  idempotencyKey: string;
}): Promise<TrainingCostEstimateInputSet>;

Parameters

string

required

Training draft ID with prefix trg..

string

required

A caller-generated key reused for retries of one logical request.

Returns

Promise<TrainingCostEstimateInputSet> Frozen training and validation inputs prepared for a cost estimate.

TrainingCostEstimateInputSetId

required

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

TrainingId

required

Training draft ID with prefix trg..

string

required

Dataset cutoff for these frozen inputs, as an ISO 8601 timestamp.

string

required

Deadline for estimating and starting a run with this input set, as an ISO 8601 timestamp.

object

required

Export IDs to poll until all non-null exports succeed before estimating the cost.

Show Fields

string

required

Export ID with prefix dex. used to validate the training examples.

string | null

required

Export ID with prefix dex. used to validate the validation examples, or null when no validation selection exists.

string

required

Time this input set was prepared, as an ISO 8601 timestamp.

Errors

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

Status	Description
409	Expired replay or too many unconsumed Input Sets
429	Rate limit exceeded

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

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

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

const inputSet = await client.trainings.prepareCostEstimateInputs({
  trainingId: "trg.019a0000-0000-7000-8000-000000000001",
  idempotencyKey: crypto.randomUUID()
});
console.log(inputSet);

{
  "id": "tei.019a0000-0000-7000-8000-000000000001",
  "trainingId": "trg.019a0000-0000-7000-8000-000000000001",
  "cutoff": "2026-01-01T00:00:00Z",
  "expiresAt": "2026-01-01T00:00:00Z",
  "exports": {
    "training": "dex.019a0000-0000-7000-8000-000000000001",
    "validation": null
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

client.trainings.prepareCostEstimateInputs()

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors