Каталоги моделей
Получайте нативные идентификаторы моделей и управляйте их видимостью и правами маршрутизации.
Используйте это, когда список моделей пуст или вам нужно контролировать доступные модели. Ваш первый запрос.
SubLane Обнаружены идентификаторы моделей для каждой учетной записи подписки и выводится каталог каждого пула из его включенных учетных записей. Списки разрешений пула остаются политикой, принадлежащей администратору; обнаружение никогда не заменяет их. Представленная модель описывает поддержку вверх по течению, а не оставшуюся квоту или успешный тест поколения.
Пример каталога моделей с синтетическими идентификаторами моделей:

Синхронизация и хранение
Счет импорта, OAuth Повторное авторизация очищает старый каталог, даже если представленный токен не изменился. Существующие учетные записи обнаруживают лениво, когда их каталог или пул читается, или перед их первым запросом модели. Повторное включение учетной записи проверяет, нуждается ли ее сохраненный каталог в обновлении. Проверить соединение и Обновление моделей Они проводят одну и ту же операцию обнаружения.
Консолидированная схема хранит ограниченный JSON Снимок модели и пересмотр жизненного цикла на каждой учетной записи. Снимок содержит отсортированные, дублированные идентификаторы нативной модели, последнее успешное время наблюдения и маркер источника обнаружения. Маркер включает в себя Codex клиентская версия и адаптерная правка; обновление этого контракта обновляет старые или немаркированные снимки независимо от их возраста. Каждая учетная запись ограничена 512 идентификаторами моделей не более 128 символов ASCII; никаких инструкций, манифестов или учетных данных не хранятся. Нулевой снимок означает неизвестную поддержку. Успешно полученный пустой список - известный пустой каталог.
Снимки свежи в течение 15 минут. Несвежее чтение возвращает сохраненное значение и запускает общее обновление фона. Периодического опроса вверх по течению нет. Холодные запросы также присоединяются к обновлению при изменении маркера источника обнаружения. Неудавшееся обновление обновления может сохранить ранее известные возможности, но устаревший каталог не может доказать неподдерживаемость незарегистрированной модели. Ручное обновление имеет пятисекундное охлаждение; неудавшееся обновление сохраняет последний успешный снимок и отступает на 30 секунд. Неудачные наблюдения никогда не меняют свою временную метку. Через 24 часа старый снимок остается видимым для администраторов, но исключается из рекламируемых и маршрутизируемых моделей до обновления. Обновление состояния и обратного хода являются локальными процессами; успешные снимки выживают при перезапуске.
Одновременно выполняются не более двух операций обнаружения моделей в пределах ёмкости пространства: по умолчанию 128 операций, настройка SUBLANE_GATEWAY_CAPACITY. Читатели одного аккаунта и ревизии разделяют операцию с контекстом процесса и сроком 45 секунд. Отключение браузера отменяет только его ожидание. Первичное обнаружение также ограничено 45 секундами в целом. При завершении задачи отменяются и ожидаются до закрытия SQLite; свежий каталог не требует внешнего обращения.
Условные записи отклоняют результаты устаревшей авторизации, отключенной / удаленной учетной записи или более ранней ревизии жизненного цикла. Codex Версия один раз; результаты от версии, вытесненной во время сетевого запроса, отбрасываются, а снимки сохраняют версию, фактически отправленную вверх по течению. Системные настройкиПрава доступа на пулы, членство, политика и постоянные снимки снова читаются в одном месте. SQLite Модели, удаленные из пула, не могут просочиться через обновление, начатое до редактирования.
Каталоги пулов и маршрутизация
Эффективный каталог пула — объединение идентификаторов из пригодных снимков аккаунтов без повторов, отфильтрованное точным списком разрешённых моделей пула. Отключённые аккаунты и аккаунты, требующие повторной авторизации, исключаются. Периоды ожидания, параллелизм и остаток квоты подписки проверяются отдельно во время выполнения; наличие модели в списке не гарантирует немедленно доступного места для запроса.
Каталоги аккаунтов, групп и ключей используют нативные идентификаторы моделей без дополнительных префиксов. Подходящие ресурсы Codex, Claude, Antigravity, Grok Build и OpenAI-совместимых API участвуют согласно маршрутизации и резервному переходу группы. Публичный каталог исключает скрытые модели. Одинаковые видимые ID объединяются; owned_by равен sublane, если видимый маршрут предоставляют несколько провайдеров. Для прав вариантов рассуждения сохраняется полный ID, для проверки возможностей используется обнаруженная базовая модель. Общий предел — 4 096 ID. Старые префиксы провайдера поддерживаются и при явном указании сужают выбор.
Перед выводом, открытие нагревает отсутствующие/сталевые каталоги для подходящих поставщиков в пуле; явный устаревший префикс сужает открытие для этого поставщика. Codex Планировщик перепроверяет политику пула и снимки учетных записей в своей транзакции выбора, отфильтровывает учетные записи, которые не поддерживают запрашиваемую модель, затем применяет существующие правила параллелизма, охлаждения и ротации. 404 model_not_availableВозвращение неизвестных или сверхвозрастных способностей 503 model_catalog_unavailable Другие подходящие, известные учетные записи могут по-прежнему служить моделью, когда открытие сверстника не удается.
Нативные запросы выбирают среди разрешенных, доступных учетных записей, сообщающих модель. Выбор и бронирование учетной записи разделяют существующую блокировку транзакций и процессов. Существующие нативные разговоры сохраняют единую учетную запись, связывающую поставщиков. Когда клиент явно меняет модели и отправляет полную портативную историю, учетная запись, которая не поддерживает новую модель, может быть заменена соответствующей учетной записью в том же пуле. Если текущий счет поддерживает новую модель, он остается выбранным. Насыщение, охлаждение, удаление, отключение и потеря поддержки неизменной модели никогда не вызывают автоматического отказа.
Продолжения провайдера сохраняют свою учетную запись: ссылки на предыдущий ответ или сохраненный разговор, ссылки на элементы, зашифрованные рассуждения / действия, подписанные Claude Размышления и Gemini кэшированный контент / подписи не могут разрешить переключение модели. WebSocket повороты не могут изменить модель; послать независимую полную историю response.create Вместо этого повернитесь. HTTP previous_response_id остается отклоненным; отправить полный ввод без этой ссылки. conversation_account_unavailable.
Существующий account_affinity Таблица хранит нативную маршрутизацию под auto Обновленные привязки с неизвестными метаданными модели остаются прикрепленными до тех пор, пока поддерживаемый запрос не запишет модель; начать новый разговор, если он недоступен. Единый привязка унаследованного провайдера принимается без изменения хэша учетной записи или сеанса восходящего потока; множественные привязки унаследованного под одним и тем же сеансом остаются неоднозначными. Явные запросы унаследованного префикса сохраняют свои привязки у конкретного провайдера только тогда, когда этот провайдер активен. APIДобавлена привязка ключа/счета.
UI и браузерные API
- Аккаунты → Модели отображает последние зарегистрированные идентификаторы моделей учетной записи, время наблюдения и состояние синхронизации с ручным обновлением.
- Бумаж счетов → Модели Показывает автоматически производный, фильтрованный политикой каталог пулов. Редактор пула продолжает управлять списком разрешений отдельно.
- API Ключи → Модели показывает текущий авторизованный каталог пула ключа. ввозить в CC Switch Предоставляет доступный для поиска образец, использующий тот же каталог.
| Конечная точка | Доступ | Цель |
|---|---|---|
GET /api/accounts/{id}/models | Администратор | Прочитайте снимок учетной записи и инициируйте застойное открытие |
GET /api/channels/{id}/models | Администратор | Прочитайте снимок учетной записи и инициируйте застойное открытие |
POST /api/accounts/{id}/models/refresh | Администратор, точное происхождение, пустой JSON тело | Обновить или присоединиться к открытию учетной записи |
POST /api/channels/{id}/models/refresh | Администратор, точное происхождение, пустой JSON тело | Обновить или присоединиться к открытию учетной записи |
GET /api/groups/{id}/models | Администратор | Прочитайте производный каталог пула |
GET /api/keys/{id}/models | Позволяет владельцу ключа | Прочитайте каталог активных ключей, не расшифровывая его секрет |
GET /v1/models | Ключ от шлюза | Верните стандартный список моделей для пула ключей |
Личный доступ к каталогу перепроверяет включение ключа, истечение срока действия, отзыв и доступ к пулу. Администраторы не могут использовать персональную конечную точку для проверки ключа другого владельца. Responses Они содержат метаданные модели и совокупные показатели свежести, а не идентификаторы подписных счетов, имена или учетные данные. Частичный ответ пула показывает, что некоторые каталоги счетов остаются неизвестными, вместо того, чтобы рассматривать их как поддержку каждой модели.
Контрольная граница
Автоматизированные тесты используют синтетические учетные записи и локальные поддельные восходящие потоки. Они охватывают персистентность перезапуска, авторитетные пустые каталоги, неудавшиеся повторные задержки / откаты, гонки авторизации и отзыва пула, отмену / закрытие, маршрутизацию смешанной учетной записи, списки разрешений пула, варианты мышления, аффинити разговора, владение конечными точками и персистентность свежей схемы. Фронтальные тесты охватывают состояния каталога, выбор модели клавиатуры и устаревшие ответы после изменения идентичности. Discovery не исследует генерацию модели, и каталоги вверх по течению могут меняться между синхронизацией и фактическим запросом.
Диагностика доступности модели
Диалоги моделей пула и персонального ключа позволяют вам проверить собственный идентификатор модели. Результаты показывают местное право на новый запрос, причины исключения, время наблюдения и известные времена повторного использования. Администраторы могут проверять данные на уровне учетной записи; персональные ключи получают агрегаты без идентификаторов подписки. Проверки не выполняют вывод, обновляют метаданные, резервируют слоты или создают привязки для разговора. Неизвестные / статические данные остаются неизвестными. Право на получение не гарантирует успех в верхнем потоке; ограничения на ключ, член и квоты использования по-прежнему применяются и существующие разговоры сохраняют свою учетную запись.
Ручная проверка моделей
Администраторы могут открыть список моделей аккаунта или API-канала и выбрать Проверить рядом с моделью. Каждая проверка отправляет реальный запрос генерации, расходует квоту провайдера и занимает доступную ёмкость. Время ожидания — 30 секунд. Результат показывает успех или ошибку без чувствительных данных и длительность в миллисекундах для этого ресурса на момент проверки. Доступ личного ключа к группе и выделенный ему лимит не проверяются. Локальная диагностика доступности выше не отправляет запросов генерации.
Видимость у провайдера и поддержка маршрутизации учитываются отдельно: скрытые модели не появляются в каталогах браузера или GET /v1/models, но запрос с явно указанным ID может быть направлен на них, если аккаунт поддерживает модель и текущая политика её разрешает. Проверки прав, квот и доступной ёмкости сохраняются.
Видимость внутренних моделей
Модели Antigravity с isInternal и Grok Build с hidden или _meta.hidden остаются доступными для вызова. После входа каталоги аккаунтов, групп ресурсов и личных ключей показывают их после видимых моделей с отметкой скрытой модели; внутри обеих групп действует алфавитная сортировка. GET /v1/models и список выбора CC Switch их исключают. Явные вызовы по-прежнему проверяют политики, права, квоты, выделенные лимиты, ёмкость, периоды ожидания и состояние аккаунта. Grok читает каталог авторизованной подписки и нормализует псевдонимы в нативные идентификаторы маршрутизации. Старые каталоги обновляются автоматически для получения метаданных видимости.