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

# Официальный сервис моделей

> Облачные модели Linkly AI: войдите и начните чат без собственного API Key, используя единый пул квоты.

## Что это такое

Официальный сервис моделей обеспечивает работу Chatbot без настройки стороннего провайдера. Войдите в аккаунт, выберите модель и отправьте сообщение; ключи поставщиков вводить не нужно.

Бесплатные аккаунты тоже получают квоту без банковской карты. Сервис покрывает только chat inference: индексирование, OCR, локальная ASR, семантический поиск и MCP работают на компьютере и не зависят от него.

## Начало работы

<Steps>
  <Step title="Войдите">В **Settings → Account** выполните браузерный OAuth. Ключ получается автоматически; без браузера вставьте `lkai_` из Dashboard в optional manual section.</Step>
  <Step title="Проверьте provider">В **Settings → AI → Providers** карточка **Linkly Official** должна иметь Ready. Refresh/Add models синхронизирует каталог сервера.</Step>
  <Step title="Выберите модель">Picker находится справа от composer и группирует модели по provider. Badge показывает multiplier; в Settings → AI задаются default model и язык ответа.</Step>
  <Step title="Задайте вопрос">При необходимости укажите библиотеку или документы через `@`.</Step>
</Steps>

## Доступные модели

Каталог делится на Basic для всех и Frontier для Pro; Free вообще не видит недоступные frontier models. Список, context windows и multipliers доставляются сервером и могут меняться — источником истины является Desktop.

## Квота

### Единый пул

Квота общая для всех официальных моделей и не биллится по токенам. **1 unit = один запрос к модели ×1**; ×0.5 тратит половину, ×4 — четыре units. Badge в picker показывает multiplier. Для обычных вопросов экономнее Basic, Frontier — для задач, где действительно нужно глубокое reasoning.

### Параллельные временные окна

Одновременно и независимо работают fixed windows **5 часов, 7 дней и 30 дней**. Заполнение любого блокирует pool, даже если два других свободны. Цикл начинается с первого billable request и по окончании восстанавливает весь лимит сразу. Pro имеет больше во всех окнах; точные числа и reset time показывает Model quota/website.

### Что расходует квоту

| Действие                                             | Расходует    |
| ---------------------------------------------------- | ------------ |
| Новое сообщение / новый turn                         | Да           |
| Retrieval tool calls и чтение документов внутри turn | Нет отдельно |
| Автоматический title и `/compact`                    | Да           |
| Открытие quota panel                                 | Нет          |
| Third-party/local model                              | Нет          |

То есть семь поисков и десяток чтений внутри одного ответа делят deduction сообщения, а не оплачиваются отдельно.

## Где проверить и что будет при исчерпании

Откройте **Model quota** с gauge внизу sidebar или [Dashboard](https://linkly.ai/dashboard): три строки показывают remaining/total и reset. Без входа панель просит sign in, offline — проверить соединение; official models требуют интернет.

После заполнения окна новый turn немедленно завершается сообщением с окном и точным временем восстановления. История, индекс и прошлые сообщения не меняются. Переключение на более дешёвую official model уже не поможет, потому что ограничен общий pool; можно дождаться reset или перейти на third-party/local provider.

## Собственный провайдер (BYOK)

Официальный сервис необязателен. В **Settings → AI → Providers → Custom provider** доступны 12 presets: OpenAI, DeepSeek, Mistral, Groq, OpenRouter; Qwen, MiniMax, Moonshot, Zhipu, SiliconFlow; Ollama и LM Studio. Preset заполняет только Base URL: модели автообнаруживаются через `/v1/models` или вводятся вручную. Локальный server обычно не требует key.

### Выбор источника

| Источник        | Свой key | Оплата/квота          | Данные                              |
| --------------- | -------- | --------------------- | ----------------------------------- |
| Linkly Official | Нет      | Общий pool, есть Free | Через Linkly к отобранному provider |
| Third-party     | Да       | Напрямую у provider   | Напрямую provider, не через Linkly  |
| Local           | Нет      | Собственный compute   | Не покидают устройство              |

<Warning>Если custom provider не сообщает `context_length` (часто Ollama/LM Studio), процент контекста неизвестен и auto-compaction не включается. Следите за длиной сами, используйте `/compact` или новый чат.</Warning>

## Данные и приватность

| Возможность        | Куда идут данные                                 |
| ------------------ | ------------------------------------------------ |
| Linkly Official    | Сначала Linkly servers, затем curated provider   |
| Direct third-party | Прямо в API provider, минуя Linkly               |
| Local model        | Остаются на устройстве                           |
| Embedding/OCR      | Локально; только файлы моделей скачиваются с CDN |

<Warning>Official service передаёт через Linkly и upstream-provider сообщения **и извлечённые фрагменты документов**. Исходные файлы целиком не загружаются и не меняются. Проверить активные внешние потоки можно в **Settings → Data Privacy**.</Warning>

Каждый запрос несёт app name/version в headers для attribution, но без identifying data.

## Частые вопросы

<AccordionGroup>
  <Accordion title="Можно пользоваться Chatbot без входа?">Да: добавьте third-party endpoint либо Ollama/LM Studio. Только official service требует аккаунт; поиск, индекс и MCP — нет.</Accordion>
  <Accordion title="Это фиксированное число сообщений в день?">Нет. Окна 5h/7d/30d действуют одновременно; burst чаще упирается в 5h, постоянная нагрузка — в 30d.</Accordion>
  <Accordion title="Сколько даёт более дешёвая модель?">Прямая пропорция multiplier: пятикратная разница даёт примерно в пять раз больше turns из pool.</Accordion>
  <Accordion title="Model quota влияет на cloud library search?">Нет, это отдельные системы квот.</Accordion>
  <Accordion title="Почему нет Gemini preset?">Его OpenAI-compatible auth передаёт key в URL `?key=`, а текущий pipeline ожидает Bearer header; tool calling также пока недостаточно совместим.</Accordion>
  <Accordion title="Новый компьютер просит войти">Quota следует за аккаунтом, поэтому достаточно OAuth на новом устройстве. Custom provider URLs/keys локальны и настраиваются заново.</Accordion>
</AccordionGroup>

## Дополнительные материалы

* [Chatbot](/docs/ru/use-chatbot)
* [Аккаунт](/docs/ru/linkly-account)
* [Установка без интернета](/docs/ru/offline-models)