client.models.create()

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

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

const model = await client.models.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  baseModelId: "qwen3-4b"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "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 model = await client.models.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  baseModelId: "qwen3-4b"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Send a name and baseModelId to create a model in the project. Returns its metadata; model versions are created separately.

Signature

Method signature on client.models:

create(args: {
  projectId: string;
  name: string;
  description?: null | string;
  baseModelId: "qwen3-4b" | "qwen3-8b" | "qwen3-32b" | "qwen3-235b";
}): Promise<Model>;

Parameters

string

required

Project ID with prefix pp..

string

required

Name of the model, between 1 and 120 characters after trimming.

null | string

Description of the model; omit or send null to leave it unset.

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

required

The stable product identifier of a catalog base model.

Returns

Promise<Model> A project-owned logical Model containing immutable versions.

ModelId

required

Model ID with prefix mdl..

ProjectId

required

Project ID with prefix pp..

string

required

Name of the model.

string | null

required

Description of the model, or null when none was provided.

BaseModelId

required

The stable product identifier of a catalog base model.

string | null

required

Time the model was archived, as an ISO 8601 timestamp, or null while it is active.

string

required

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

string

required

Time the model was last updated, as an ISO 8601 timestamp.

Errors

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

Status	Description
429	Rate limit exceeded

HTTP endpoint: POST /projects/{projectId}/models.

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

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

const model = await client.models.create({
  projectId: "pp.019a0000-0000-7000-8000-000000000001",
  name: "example",
  baseModelId: "qwen3-4b"
});
console.log(model);

{
  "id": "mdl.019a0000-0000-7000-8000-000000000001",
  "projectId": "pp.019a0000-0000-7000-8000-000000000001",
  "name": "<string>",
  "description": null,
  "baseModelId": "qwen3-4b",
  "archivedAt": null,
  "createdAt": "2026-01-01T00:00:00Z",
  "updatedAt": "2026-01-01T00:00:00Z"
}

Reference

TypeScript SDK

CLI

HTTP API

Signature

Parameters

Returns

Errors