Провайдеры API

Возможности

• Карточка на провайдера: цветной индикатор состояния (зелёный — работает, красный — последняя проверка упала, жёлтый — ещё не проверялся или идёт проверка, серый — выключен), имя, тип протокола, внутренний идентификатор, ключ в замаскированном виде, адрес сервера и первые несколько моделей со счётчиком «+ещё N».
• Строка последней проверки: «ок», сколько занял ответ и когда он был, а при неудаче — код ответа или текст ошибки. Рядом может висеть подсказка: ключа нет, прошлый тест упал, провайдер выключен.
• Тумблер вкл/выкл прямо на карточке. Выключенный провайдер остаётся в списке, но его модели перестают использоваться и исчезают из общего списка моделей.
• Кнопка test на карточке отправляет настоящий короткий запрос к первой модели провайдера и показывает «ок», время ответа и номер модели.
• Кнопка edit открывает форму правки, кнопка «⋯» — меню действий.
• Проверка конкретной модели: в форме на шаге «тест и сохранение» можно выбрать модель вручную и отправить один настоящий запрос.
• Меню действий: проверить модель, заново получить список моделей, скопировать адрес провайдера или список моделей, включить или выключить, удалить. Если провайдер отдаёт лимиты, добавляются ещё «расход» и «обновить лимиты»; у DeepSeek — «баланс» и «обновить баланс».
• Если лимиты есть, на карточке появляется блок расхода: тонкие полоски по окнам с процентами, меткой «устарело», если данные старые. Нажатие открывает подробный расход.
• У DeepSeek на карточке — статус доступности (available/insufficient) и итог по каждой валюте (CNY, USD). Валюты не складываются и не конвертируются; в шторке Balance видны total, granted и topped up по каждой из них.
• Поиск по названию, внутреннему имени, адресу, протоколу и названиям моделей.
• Обновление списка потягом вниз.
• Полоска моделей на карточке — сводка со стрелкой: тап открывает форму провайдера сразу на шаге моделей. У каждой модели видны имя и контекст, а редактор контекста и флаги «вызовы инструментов»/«рассуждения» раскрываются кнопкой «настроить».
• Шторка расхода: процент израсходования каждого окна (полоска краснеет на 85%), время до обновления окна и график истории расхода.
• Форма провайдера в три шага: подключение (включая API-ключ), модели, проверка и сохранение. Кнопка Save закреплена внизу и доступна с любого шага; тест не обязателен.
• В форме — выбор одного из готовых провайдеров: подставляются адрес, протокол и список моделей, остаётся вписать только ключ.
• Кнопка «Discover models» сама спрашивает у провайдера его каталог моделей. Дальше список можно фильтровать поиском, отмечать нужные чипами, сгруппированными по семейству моделей, нажать «all» или «none», и видеть счётчик выбранного.
• При правке существующего провайдера ключ можно не трогать: по умолчанию остаётся сохранённый, и поле ввода появляется только после переключателя «заменить».

Технические данные

Почему ключ нельзя посмотреть целиком

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

Почему после переключения нужно подождать

Тумблер отвечает мгновенно, и карточка сразу показывает новое состояние. Но чтобы провайдер появился или исчез у агентов, нужно пересобрать их список моделей и перезапустить — это делается в фоне и занимает до 30 секунд. В эти полминуты агент может ещё пользоваться старым списком.

Когда одна модель есть у нескольких провайдеров

Модель можно указать одним именем, если такая модель есть только у одного включённого провайдера. Если одинаковое имя нашлось у нескольких, запрос будет отклонён с подсказкой — тогда нужно указать пару «провайдер/модель» например deepseek/deepseek-v4-flash.

Про отметку «видит картинки»

Модели, которые умеют принимать картинки, определяются по имени: если в имени есть vision, vl, multimodal или известный префикс вроде gpt-4o или claude-, она считается зрячей автоматически. Ничего не подсказало — модель можно добавить вручную на экране Vision кнопкой «+ модель»: она получит ручной флаг зрения и появится в списке источников. Ложное «видит» хуже, чем пропущенная зрячая модель, поэтому автоматика настроена осторожно.

Что агент умеет с провайдерами

Прямых инструментов нет

Агент не видит список провайдеров, ключи и лимиты. Он не может добавить, изменить или удалить провайдера, запустить проверку, получить список моделей или пометить модель как зрячую — таких команд в его наборе просто нет.

Пользоваться моделями может

Запрос к модели агент делает сам, указав её имя: можно написать пару «провайдер/модель», можно просто имя модели, если оно однозначное. Если модель не указана, берётся первая из настроенной цепочки моделей. Так агент может говорить с любой подключённой моделью, но управлять подключением — не может: это целиком ручная работа человека через экран.

Отдельный инструмент проверки статуса показывает веб-ИИ аккаунты, а не провайдеров из этого раздела, — путать их не стоит.

Ограничения

• Тест модели — настоящий запрос: он уходит провайдеру по-настоящему, попадёт в его статистику и может немного израсходовать квоту.
• Поиск моделей требует ключа. Без него каталог вернёт пустоту или ошибку.
• Лимиты есть не у всех провайдеров, и точные окна присылает только сам провайдер.
• Отметка «видит картинки» ставится руками: если ошибиться, картинка уйдёт модели, которая её не принимает, и придёт ошибка от провайдера.
• В списке показываются только общие провайдеры; служебные и внутренние записи в этот экран не попадают.
• Удаление провайдера убирает его у всех агентов сразу и отменить это нельзя.
• Внутренний идентификатор провайдера нельзя менять на уже занятый — форма подскажет это под полем.