Планируется

Запасные модели: безопасное переключение в своём приложении

Как подготовить резервную модель, сравнить возможности и стоимость и не создать двойную платную генерацию при ошибке.

API Токенмоста работает

Базовый адрес — https://tokenmost.ru/v1. Создайте ключ в личном кабинете, выберите модель в каталоге и отправьте первый запрос. Методы, которые ещё не доступны, отмечены отдельно.

Как это устроено

Токенмост пока не предоставляет автоматический маршрут запасных моделей. Приложение может выбрать другой точный model для новой операции, но только после выяснения исхода первой: таймаут не доказывает, что поставщик не выполнил запрос.

Что потребуется

  • Два точных ID текстовых моделей с доступным нужным методом и опубликованными тарифами.
  • Проверка контекста, tools и формата ответа для обеих моделей.
  • Журнал операций с Idempotency-Key, бюджетом и статусом расчёта.

Порядок работы

  1. Выберите основную и резервную модели по одному типу задачи, а не только по названию.
  2. Прогоните одинаковые контрольные запросы и сравните формат, качество, контекст и стоимость.
  3. Отправляйте запрос к основной модели с сохранённым Idempotency-Key.
  4. При неопределённом сетевом исходе сначала проверьте историю операции или повторите то же тело с тем же ключом.
  5. Если первая операция точно не выполнена и ошибка допускает переключение, создайте новую операцию с резервной моделью.
  6. Запишите фактический ID модели, причину переключения и итоговый расход.

Готовая конфигурация

Политика вашего приложения — не параметр API

{
  "primary": "PRIMARY_MODEL_ID",
  "backup": "BACKUP_MODEL_ID",
  "switchOnlyAfterConfirmedFailure": true,
  "neverSwitchOn": [
    400,
    401,
    402
  ],
  "maxBackupAttempts": 1
}

Что учесть

Публичный fallback-маршрут планируется. До его появления логика выбора и проверки исхода остаётся в вашем приложении; не пытайтесь передавать JSON-политику выше как тело Chat Completions.

Ожидаемый результат

Резерв запускается только после подтверждённого неуспеха основного запроса. Пользователь получает ответ, а журнал показывает точную модель и одну учтённую успешную операцию.

Ограничения расходов

Резерв может быть дороже. Задайте предел стоимости в приложении и бюджет ключа. Смена model меняет тело запроса, поэтому старый Idempotency-Key нельзя переиспользовать для другой модели.

Статус функции

JSON выше — локальная конфигурация приложения. В Токенмосте нет публичного поля fallback_models и нет автоматического переключения на сервере.

Ошибки и диагностика

400 или 401

Исправьте параметры или ключ; смена модели не решит ошибку авторизации и JSON.

402

Остановите цепочку и проверьте баланс и бюджет ключа.

429

Проверьте Retry-After и лимиты, затем решите, ждать или переключать подтверждённо неисполненную операцию.

Таймаут

Не отправляйте сразу запрос другой модели: исход первой операции неизвестен.

Формат ответа изменился

Проверьте поддержку tools/JSON и откатите резерв до совместимой модели.

Источники и связанные инструкции

Читайте дальше

← Все инструкции