Overview

HowToFix — это пункт доступа к моделям. Вы открываете один аккаунт, создаёте один токен и получаете доступ к каждой модели в Model Square через единый базовый URL, совместимый с OpenAI.

Почему существует HowToFix

Получить доступ к современным моделям сложнее, чем использовать их. Работающая конфигурация обычно означает несколько аккаунтов у нескольких провайдеров, каждый со своей регистрацией, своей картой, своей панелью управления и своими ограничениями скорости. Модели, которые Вам действительно нужны, распределены между ними всеми, и каждый новый проект означает повторение всей этой обвязки.

HowToFix был создан, чтобы свести всё это к одному аккаунту и одному базовому URL. Проблемы, на которые он нацелен, в порядке частоты их возникновения:

ПроблемаЧто HowToFix делает вместо этого
Много провайдеров, много ключей. Проект, которому нужны Claude, GPT и Gemini, хранит три ключа, три конфигурации SDK и три платёжных отношения. Один токен, один базовый URL. Смена модели — это изменение поля model, а не Вашего кода.
Трения при оплате. Большинство провайдеров требуют карту и ежемесячное обязательство, прежде чем Вы сможете отправить запрос. Предоплаченный баланс. Вы пополняете его на сумму, которую хотите потратить, и аккаунт расходует её по каждому запросу. Карта не требуется для наличия аккаунта, и неиспользуемый аккаунт ничего не стоит.
Непрозрачные расходы. Счёт приходит в конце месяца, и Вы не можете определить, какой проект его вызвал. Журналы использования по каждому запросу и лимиты по каждому токену. Каждый вызов приписывается создавшему его токену, и токен можно ограничить или отозвать отдельно.
Привязанные клиенты. Инструменты, которые понимают только протокол одного поставщика, не могут использовать другую модель. Совместимость с OpenAI, а также нативные маршруты Anthropic /v1/messages и Gemini. Существующие SDK OpenAI работают при изменении только base_url.
Отсутствие понимания того, что хорошо. Качество моделей меняется ежемесячно, и маркетинговые страницы за этим не следят. Рейтинги использования показывают, какие модели люди действительно запускают, а Model Square показывает актуальную цену каждой из них.

Что это такое, если точно

HowToFix — это шлюз. Он не обучает модели и не перепродаёт мощности одного провайдера. Запросы поступают на api.howtofix.id, измеряются против Вашего баланса и перенаправляются в тот upstream, который обслуживает данную модель. Из этого следуют три вывода, которые стоит изложить прямо:

  • Цены указаны за токен и видны до отправки. Model Square — это прайс-лист; отдельного тарифного справочника нет.
  • Доступность следует за upstream. Модель может быть в списке и всё равно возвращать ошибку, если её upstream недоступен. Статус Ваших собственных запросов находится в журнале использования в консоли.
  • Ваш аккаунт — это единица управления. Баланс, токены и журналы находятся на howtofix.id; хост API обслуживает только трафик моделей.

Ключевые возможности

ВозможностьОписание
Один ключ, много моделейЕдиный токен sk- открывает доступ к каждой модели в Model Square. На момент написания в списке 113 моделей.
API, совместимый с OpenAI/v1/chat/completions, /v1/models, эмбеддинги, изображения, аудио и многое другое. Направьте любой SDK OpenAI на базовый URL, и он заработает.
Нативные маршруты провайдеровМаршруты Anthropic /v1/messages и Gemini обслуживаются напрямую, поэтому клиенты, написанные под эти протоколы, не нуждаются в слое трансляции.
Оплата по факту использованияБаланс расходуется по каждому запросу. Чтение кэша, токены рассуждений и вывод изображений тарифицируются отдельно, а не сводятся в одну ставку.
Управление по каждому токенуЛюбой токен может нести собственную квоту, список разрешённых моделей и срок действия, и его можно отозвать, не затрагивая остальную часть аккаунта.
Журналы использованияКаждый запрос фиксирует модель, токены, стоимость и результат с возможностью фильтрации по токену и времени.
Командная консольОдин аккаунт может содержать несколько токенов для разных проектов или людей, каждый с независимыми ограничениями.
Терминальный агентHowToFix CLI — это агент для программирования, который проходит аутентификацию под этим же аккаунтом.

Чем это отличается от прямого обращения к провайдеру

АспектОдин провайдерHowToFix
Аккаунтов в управленииПо одному на провайдераОдин
Ключей в Вашем проектеПо одному на провайдераОдин
Смена моделиНовый SDK, новый ключ, новая конфигурацияИзменение строки model
ОплатаПо каждому провайдеру, обычно сначала картаОдин предоплаченный баланс
Видимость расходовПанель управления по каждому провайдеруОдин журнал по всем моделям
Лимиты по проектамОбычно недоступныТокен на проект, каждый с лимитом

Навигация по документации

#СтраницаОписание
1ДокументацияПолное руководство: аккаунты, правила регистрации, ключи, первый вызов, эндпоинты, ошибки
2CLIУстановите агент для программирования, подключите его к этому аккаунту и используйте из терминала
3Model SquareАктуальные цены и каталог моделей
4РейтингиКакие модели действительно используются
5О насЧто такое HowToFix, где что находится и позиция по лицензиям
6Условия · Конфиденциальность · Файлы cookieПравила и обработка данных
Получить ключЧитать документацию