client.models.getVersion()

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

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

const version = await client.models.getVersion({
  modelVersionId: "mdv.019a0000-0000-7000-8000-000000000001"
});
console.log(version);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "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 version = await client.models.getVersion({
  modelVersionId: "mdv.019a0000-0000-7000-8000-000000000001"
});
console.log(version);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

Return the immutable version metadata, file manifest, and source training run.

Signature

Method signature on client.models:

getVersion(args: {
  modelVersionId: string;
}): Promise<ModelVersion>;

Parameters

string

required

Model version ID with prefix mdv..

Returns

Promise<ModelVersion> One immutable version of a project Model.

ModelVersionId

required

Model version ID with prefix mdv..

ModelId

required

Model ID with prefix mdl..

string

required

Name of this model version.

number

required

Positive revision number assigned to this version within its model.

object

required

Model weights or LoRA adapter, its base model, parent, and file manifest.

Show kind: "lora_adapter"

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model required to run these weights or this adapter.

ModelVersionManifest

required

Files that make up the model version, with sizes and checksums.See the HTTP endpoint for the complete schema.

"lora_adapter"

required

Content kind: lora_adapter contains an adapter; full contains complete model weights.

ModelVersionParent

required

Parent model source; may be absent for full weights with no recorded parent.

Show type: "base_model"

"base_model"

required

Parent source: base_model for a catalog model or model_version for a published project version.

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Parent source: base_model for a catalog model or model_version for a published project version.

string

required

Parent model version ID with prefix mdv..

Show kind: "full"

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model required to run these weights or this adapter.

ModelVersionManifest

required

Files that make up the model version, with sizes and checksums.See the HTTP endpoint for the complete schema.

"full"

required

Content kind: lora_adapter contains an adapter; full contains complete model weights.

ModelVersionParent

Parent model source; may be absent for full weights with no recorded parent.

Show type: "base_model"

"base_model"

required

Parent source: base_model for a catalog model or model_version for a published project version.

"qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b"

required

Catalog base model identifier.

Show type: "model_version"

"model_version"

required

Parent source: base_model for a catalog model or model_version for a published project version.

string

required

Parent model version ID with prefix mdv..

object

required

Training run that produced this model version.

Show Fields

"training_run"

required

Producer kind; training_run means this version was produced by a training run.

string

required

ID of the training run that produced the version, with prefix trn..

string

required

Time the model version was created, as an ISO 8601 timestamp.

Errors

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

Status	Description
429	Rate limit exceeded

HTTP endpoint: GET /model-versions/{modelVersionId}.

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

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

const version = await client.models.getVersion({
  modelVersionId: "mdv.019a0000-0000-7000-8000-000000000001"
});
console.log(version);

{
  "id": "mdv.019a0000-0000-7000-8000-000000000001",
  "modelId": "mdl.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "revision": 1,
  "content": {
    "runtimeBase": "qwen3-4b",
    "manifest": [
      {
        "path": "example",
        "byteSize": 0,
        "mediaType": "application/octet-stream",
        "sha256": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
      }
    ],
    "kind": "lora_adapter",
    "parent": {
      "type": "base_model",
      "baseModelId": "qwen3-4b"
    }
  },
  "producer": {
    "type": "training_run",
    "trainingRunId": "trn.019a0000-0000-7000-8000-000000000001"
  },
  "createdAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors

​Signature

​Parameters

​Returns

​Errors

Signature

Parameters

Returns

Errors