> ## 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.generationModels.list()

> List synthetic generation models.

Return the available models, supported reasoning efforts, and cost limits for synthetic generation. Use `id` as `generationModelId`. Set `reasoningEffort` only when `defaultReasoningEffort` is present. `maxCostPerAttempt` must be between `min` and `maxEstimate`; values below `typical` produce a warning.

## Signature

Method signature on `client.generationModels`:

```ts theme={null}
list(): Promise<{ defaultGenerationModelId: "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.4" | "gpt-5.4-mini" | "claude-sonnet-4-6" | "gemini-3.1-pro-preview" | "gemini-3.5-flash" | "gemini-3.7-flash" | "claude-sonnet-5" | "claude-opus-5" | "claude-fable-5" | "gpt-5.6-sol"; generationModels: GenerationModel[] }>;
```

## Parameters

This method takes no arguments.

## Returns

`Promise<{ defaultGenerationModelId: "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.4" | "gpt-5.4-mini" | "claude-sonnet-4-6" | "gemini-3.1-pro-preview" | "gemini-3.5-flash" | "gemini-3.7-flash" | "claude-sonnet-5" | "claude-opus-5" | "claude-fable-5" | "gpt-5.6-sol"; generationModels: GenerationModel[] }>`

**defaultGenerationModelId** `"gpt-5.4" | "gpt-5.4-mini" | "claude-sonnet-4-6" | "gemini-3.1-pro-preview" | "gemini-3.5-flash" | "gemini-3.7-flash" | "claude-sonnet-5" | "claude-opus-5" | "claude-fable-5" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.6-sol"` *required*

The model a synthetic node uses when `generationModelId` is omitted.

**generationModels** `GenerationModel[]` *required*

Models available for synthetic generation nodes.

**Fields**

**id** `"gpt-5.4" | "gpt-5.4-mini" | "claude-sonnet-4-6" | "gemini-3.1-pro-preview" | "gemini-3.5-flash" | "gemini-3.7-flash" | "claude-sonnet-5" | "claude-opus-5" | "claude-fable-5" | "gpt-5.6-terra" | "gpt-5.6-luna" | "gpt-5.6-sol"` *required*

The model id. Use it as `generationModelId` in a synthetic `audienceAndPricing`.

**displayName** `string` *required*

The model name the platform UI shows.

**description** `string` *required*

What the model is suited for.

**recommended** `boolean` *required*

Whether the platform recommends this model.

**defaultReasoningEffort** `"low" | "medium" | "high"`

The reasoning effort used when `reasoningEffort` is omitted. Absent when the model does not support reasoning effort; then setting `reasoningEffort` fails validation.

**budgets** `GenerationBudget[]` *required*

The `maxCostPerAttempt` bounds for each supported reasoning effort, or one entry without it.

See the [HTTP endpoint](https://docs.platform.toloka.ai/docs/api-reference/generation-models/list-generation-models.md) for the complete schema.

## 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: [`GET /generation-models`](https://docs.platform.toloka.ai/docs/api-reference/generation-models/list-generation-models).

```ts list() theme={null}
import { createClient } from "@toloka-platform/sdk";

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

const catalog = await client.generationModels.list();
console.log(catalog);
```

```json list() theme={null}
{
  "defaultGenerationModelId": "gpt-5.4",
  "generationModels": [
    {
      "id": "gpt-5.4",
      "displayName": "<string>",
      "description": "<string>",
      "recommended": false,
      "budgets": [
        {
          "min": 0,
          "typical": 0,
          "maxEstimate": 0
        }
      ]
    }
  ]
}
```


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