> Для получения чистого Markdown любой страницы добавьте .md к URL страницы.  
> Для полного индекса документации см. https://api.vega.chat/docs/llms.txt.  
> Для полного содержания документации см. https://api.vega.chat/docs/llms-full.txt.  
> Для интеграции AI‑клиентов (Claude Code, Cursor и др.) подключитесь к серверу MCP по адресу https://api.vega.chat/docs/_mcp/server.

# Free Models Router

Маршрутизатор **Free Models Router** ([https://api.vega.chat/openrouter/free](https://api.vega.chat/openrouter/free), `openrouter/free`) автоматически выбирает бесплатную модель случайным образом из доступных бесплатных моделей на VEGA. Маршрутизатор интеллектуально фильтрует модели, поддерживающие функции, необходимые вашему запросу, такие как понимание изображений, вызов инструментов и структурированные выводы.

## Overview

Вместо того чтобы вручную выбирать конкретную бесплатную модель, позвольте Free Models Router выполнить выбор за вас. Это идеально подходит для экспериментов, обучения и сценариев с небольшим объёмом, когда вам нужен вывод без затрат и без необходимости задумываться, какую именно модель использовать.

Чтобы попробовать Free Models Router без написания кода, см. руководство **Chat Playground** [/docs/cookbook/get-started/free-models-router-playground](/docs/cookbook/get-started/free-models-router-playground).

## Usage

Установите модель в `openrouter/free`:

```typescript title="TypeScript SDK"
import { OpenRouter } from '@openrouter/sdk';

const client = new OpenRouter({
  apiKey: '<VEGA_API_KEY>',
});

const completion = await client.chat.send({
  model: 'openrouter/free',
  messages: [
    {
      role: 'user',
      content: 'Hello! What can you help me with today?',
    },
  ],
});

console.log(completion.choices[0].message.content);
// Check which model was selected
console.log('Model used:', completion.model);
```

```typescript title="TypeScript (fetch)"
const response = await fetch('https://api.vega.chat/api/v1/chat/completions', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer <VEGA_API_KEY>',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    model: 'openrouter/free',
    messages: [
      {
        role: 'user',
        content: 'Hello! What can you help me with today?',
      },
    ],
  }),
});

const data = await response.json();
console.log(data.choices[0].message.content);
// Check which model was selected
console.log('Model used:', data.model);
```

```python title="Python"
import requests
import json

response = requests.post(
  url="https://api.vega.chat/api/v1/chat/completions",
  headers={
    "Authorization": "Bearer <VEGA_API_KEY>",
    "Content-Type": "application/json",
  },
  data=json.dumps({
    "model": "openrouter/free",
    "messages": [
      {
        "role": "user",
        "content": "Hello! What can you help me with today?"
      }
    ]
  })
)

data = response.json()
print(data['choices'][0]['message']['content'])
# Check which model was selected
print('Model used:', data['model'])
```

```bash title="cURL"
curl https://api.vega.chat/api/v1/chat/completions \
  -H "Authorization: Bearer $VEGA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openrouter/free",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'
```

## Response

Ответ включает поле `model`, показывающее, какая именно бесплатная модель была использована:

```json
{
  "id": "gen-...",
  "model": "upstage/solar-pro-3:free",
  "choices": [
    {
      "message": {
        "role": "assistant",
        "content": "..."
      }
    }
  ],
  "usage": {
    "prompt_tokens": 12,
    "completion_tokens": 85,
    "total_tokens": 97
  }
}
```

## How It Works

1. **Request Analysis**: Ваш запрос анализируется для определения требуемых возможностей (например, зрение, вызов инструментов, структурированные выводы).  
2. **Model Filtering**: Маршрутизатор отбирает доступные бесплатные модели, поддерживающие требования вашего запроса.  
3. **Random Selection**: Из отфильтрованного пула случайным образом выбирается модель.  
4. **Request Forwarding**: Ваш запрос пересылается выбранной бесплатной модели.  
5. **Response Tracking**: Ответ содержит метаданные, указывающие, какая модель была использована.

## Available Free Models

Free Models Router выбирает из всех в данный момент доступных бесплатных моделей на VEGA. Некоторые популярные варианты включают:

Доступность бесплатных моделей меняется часто. Проверьте страницу [models] (/aimodels?pricing=free) для актуального списка бесплатных моделей.

* **DeepSeek R1 (free)** – модель рассуждения DeepSeek  
* **Llama models (free)** – различные модели Meta Llama  
* **Qwen models (free)** – семейство Qwen от Alibaba  
* И другие модели, предоставленные сообществом

## Pricing

Free Models Router полностью бесплатен. Плата не взимается за:

* Использование самого маршрутизатора  
* Запросы, направленные к бесплатным моделям

## Use Cases

* **Learning and experimentation**: Пробуйте возможности ИИ без каких‑либо затрат  
* **Prototyping**: Создавайте и тестируйте приложения перед переходом к платным моделям  
* **Low-volume applications**: Подходит для личных проектов или демонстраций  
* **Education**: Идеально для студентов и преподавателей, изучающих ИИ

## Limitations

* **Rate limits**: У бесплатных моделей могут быть более низкие ограничения по частоте запросов, чем у платных  
* **Availability**: Доступность бесплатных моделей может варьировать; некоторые могут быть временно недоступны  
* **Performance**: Бесплатные модели могут иметь большую задержку в периоды пиковой нагрузки  
* **Model selection**: Вы не можете контролировать, какая конкретная модель будет выбрана (используйте суффикс `:free` у конкретной модели, если нужен определённый бесплатный вариант)

## Selecting Specific Free Models

Если вы хотите использовать конкретную бесплатную модель вместо случайного выбора, вы можете:

1. **Use the `:free` variant**: Добавьте `:free` к любой модели, у которой есть бесплатный вариант:  
   ```json
   {
     "model": "meta-llama/llama-3.2-3b-instruct:free"
   }
   ```

2. **Browse free models**: Посетите страницу [models] (/aimodels?pricing=free), чтобы увидеть все доступные бесплатные модели и выбрать одну напрямую.

## Related

* [Free Models Router in Chat Playground](/docs/cookbook/get-started/free-models-router-playground) – попробуйте маршрутизатор без написания кода  
* [Free Variant](/docs/guides/routing/model-variants/free) – используйте суффикс `:free` для конкретных моделей  
* [Auto Router](/docs/guides/routing/routers/auto-router) – интеллектуальный выбор моделей (платные модели)  
* [Latest Model Resolution](/docs/guides/routing/routers/latest-resolution) – всегда направляйтесь к новейшей версии семейства моделей  
* [Body Builder](/docs/guides/routing/routers/body-builder) – генерируйте несколько параллельных API‑запросов  
* [Model Fallbacks](/docs/guides/routing/model-fallbacks) – настройка резервных моделей