# Подключение моделей

Пространство ИИ и генерация заданий работают через модель, которую ты подключил сам — своим ключом провайдера или через SKILLOK.

## Где

**Настройки → ИИ**, раздел **Ключи**. Ключи организации — в её настройках, раздел **ИИ**
(см. [ИИ в организации](https://skillok.org/docs/ru/organizations/organization-settings/ai)).

Пока ничего не подключено, ИИ не работает: SKILLOK сам не подставляется, его подключают так же,
как любого другого провайдера.

## Провайдеры

| Провайдер | Ключ | Кто платит |
|---|---|---|
| **SKILLOK** | не нужен | лимит SKILLOK; модели — из набора SKILLOK |
| **OpenRouter** | свой | твой счёт у OpenRouter; модели многих компаний по одному ключу |
| **OpenAI** | свой | твой счёт у OpenAI — подключение временно на паузе |
| **DeepSeek** | свой | твой счёт у DeepSeek |
| **Qwen, Kimi, GLM, MiniMax** | свой | твой счёт у провайдера; тексты уходят в Китай или Сингапур |
| **Свой сервер** | по желанию | сервер лаборатории в формате OpenAI (vLLM, Ollama, LM Studio); только публичный адрес |

SKILLOK подключается только у человека: лимит SKILLOK есть у человека, а не у организации.

## Как подключить

**Добавить ключ** — три шага:

1. **Провайдер.**
2. **Ключ.** Вставь ключ из личного кабинета провайдера — ссылка «Где взять ключ» ведёт прямо
   туда. Ключ проверяется у провайдера бесплатным запросом, без вызова модели. Не прошёл
   проверку — не сохраняется. У SKILLOK этого шага нет: одна кнопка **Подключить**.
3. **Модель.** Выбери модель из списка провайдера. Рядом с названием — цена за миллион токенов
   в долларах: на входе (вопрос и фрагменты файлов) и на выходе (ответ).

Модель и лимит можно поменять потом на странице ключа. Сам ключ не меняется:
новый ключ — новая строка в списке.

## Какой ключ платит

Тот, что выбран в чате у поля ввода — список **Модель**. В нём твои ключи и ключи организаций,
где ты состоишь, у каждого — модель, выбранная в его настройках. Сначала выбран ключ **по
умолчанию**; первый добавленный становится им сам.

Ключ организации подключает сама организация у себя: **Настройки организации → ИИ** —
см. [ИИ в организации](https://skillok.org/docs/ru/organizations/organization-settings/ai).

Задача платит тем ключом, который был выбран, когда её поставили в очередь. Ключ удалили, пока
задача ждала, — она не выполнится. «Учиться» платит твоим ключом по умолчанию.

## Роли моделей

**Настройки → ИИ → Роли моделей**: у каждой роли — своё подключение и модель.

* **Основная** — ведёт работу, если подключение у поля ввода не выбрано, и сама зовёт
  подмодели ниже, когда это выгодно.
* **Код** — пишет и правит код по её заданию.
* **Проверяющий** — второй взгляд на правку.
* **Быстрая** — названия сессий и короткая служебная работа.
* **Зрение** — смотрит снимки страниц и слайдов, когда основная картинок не видит.
* **Запасная** — продолжает ход, если основная не ответила.

Роль не назначена — работает как без неё. Кнопки **Набор «дёшево»** и **Набор «качество»**
назначают роли из моделей, которые есть у твоих подключений сейчас.

У роли можно задать **потолок на сессию** в долларах: подмодель, дошедшая до потолка, в этой
сессии больше не зовётся, а у основной — новый ход не начинается.

Роли бывают и у организации (**Настройки организации → ИИ**): они действуют в её репозиториях
для участников, у которых своей роли нет. Сильнее всех — файл в самом репозитории
`.skillok/models.toml`:

```toml
[roles]
main = "deepseek/deepseek-v4.1-flash"
code = "qwen/qwen3-coder-next"
```

Файл называет только модели — ключей в репозитории нет: платит твоё подключение, у которого
такая модель есть. Порядок: файл репозитория → твои роли → роли организации.

## Какие репозитории читает ИИ

Те, что ты видишь, и в которых включён **ИИ** — **Настройки репозитория → ИИ**. Отдельного
разрешения на приватные репозитории и отдельного согласия больше нет: выключи ИИ в репозитории,
и он не будет его читать. Текст фрагментов уходит к провайдеру подключённой модели.

## Расход и лимит в долларах

Расход считается в долларах, как у самих провайдеров: OpenRouter сообщает стоимость каждого
вызова, для OpenAI и DeepSeek она считается по их опубликованным ценам.

На странице ключа можно поставить лимит на календарный месяц в долларах. Лимит исчерпан — Чат
LLM и генерация отвечают отказом с причиной и не переходят молча на другой ключ. Пусто — без
лимита.

В разделе **ИИ** — расход за месяц: своими ключами, ключами организаций и через SKILLOK. У
каждого ключа — сколько он потратил в этом месяце.

## Лимит SKILLOK

Модель SKILLOK ограничена твоим **тарифом**: у тарифа есть окна — несколько часов, неделя и
календарный месяц. Считается настоящая стоимость каждого вызова. На бесплатном тарифе — $1 в
месяц. Сколько окна израсходовано, видно в **Настройки → Тариф**, расход за месяц — в
**Настройки → ИИ** («из $1»).

Окно исчерпано — Пространство ИИ и генерация отвечают отказом с причиной: какое окно, и что
можно сделать — подождать, выбрать другую модель или подключить свой ключ. Если у тебя есть
другое подключение, оно сразу стоит в выборе модели. Своими ключами — без лимита SKILLOK.

### Какую модель выбрать

Модель SKILLOK выбирается на странице подключения: **Настройки → ИИ** → подключение SKILLOK.
Список разбит по цене, и у каждой модели написано, сколько вопросов примерно выйдет на $1 —
например, «≈ 1100 сообщений на $1». Сообщение здесь — типичный вопрос в Пространстве ИИ: вопрос,
фрагменты файлов и ответ.

* **Дешёвые** — больше 1000 сообщений на $1: на бесплатном тарифе хватит на весь месяц
  повседневных вопросов. По умолчанию стоит Claude Haiku 5.5.
* **Средние** — от 200 до 1000: когда дешёвая модель путается.
* **Мощные** — меньше 200: на сложные задачи; бесплатный доллар уйдёт за несколько десятков
  вопросов.

Сравнить модели подробнее — в каталоге: [Каталог моделей](https://skillok.org/docs/ru/ai-models/models).

## Как хранится ключ

Ключ шифруется сразу при сохранении и больше не показывается — видны только последние четыре
знака. Удалить ключ можно в любой момент на его странице.

---

https://skillok.org/docs/ru/account/ai-keys