> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.toloka.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# client.models.create()

> Create a project model.

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`:

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

## Parameters

**projectId** `string` *required*

Project ID with prefix `pp.`.

**name** `string` *required*

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

**description** `null | string`

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

**baseModelId** `"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.

**id** `ModelId` *required*

Model ID with prefix `mdl.`.

**projectId** `ProjectId` *required*

Project ID with prefix `pp.`.

**name** `string` *required*

Name of the model.

**description** `string | null` *required*

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

**baseModelId** `BaseModelId` *required*

The stable product identifier of a catalog base model.

**archivedAt** `string | null` *required*

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

**createdAt** `string` *required*

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

**updatedAt** `string` *required*

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

## Errors

HTTP errors throw [`PotatoApiError`](https://docs.platform.toloka.ai/docs/sdk/errors). The endpoint documents these error responses:

| Status | Description |
| - | - |
| 429 | Rate limit exceeded |

HTTP endpoint: [`POST /projects/{projectId}/models`](https://docs.platform.toloka.ai/docs/api-reference/models/create-project-model).

```ts create() theme={null}
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);
```

```json create() theme={null}
{
  "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"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.