Обновлено: 14 сентября 2026
Руководство по каталогу AI-моделей: как читать провайдеров, эндпоинты, группы и цены полезно, потому что каталоги моделей теперь делают больше, чем просто перечисляют названия. Каталог для продакшена — это поверхность маршрутизации. Он показывает продукту, инженерам и финансам, какой провайдер владеет маршрутом, какой формат API поддерживается, какая группа или план могут его использовать, какая единица тарифицируется и достаточно ли модель здорова для реального трафика.
Дорогая ошибка — читать каталог как турнирную таблицу. Строка с известной моделью всё равно может быть неподходящей для вашей нагрузки, если формат эндпоинта не совпадает с вашим SDK, единица биллинга несопоставима, маршрут ограничен группой, которой вы не пользуетесь, или статус доступности не готов для продакшена.
Это руководство по каталогу AI-моделей даёт продуктовым командам практический способ читать каталог моделей перед выбором, тестированием или маршрутизацией трафика через любой AI API gateway. В качестве рабочего примера используется публичный каталог моделей Flatkey и документация, но чеклист применим к каталогам прямых провайдеров, каталогам gateway и внутренним платформенным каталогам.
Краткий ответ: как читать каталог AI-моделей
Читайте каталог AI-моделей в таком порядке:
- Провайдер: кто управляет upstream-моделью или маршрутом.
- ID модели: точная строка, которую должно отправлять ваше приложение.
- Поддержка эндпоинтов: какой формат API принимает маршрут, например совместимый с OpenAI chat, Responses, Anthropic, Gemini, изображение, видео, embeddings или нативный маршрут.
- Группа или план: какая группа аккаунта, группа маршрута, группа квоты или тарифный план могут использовать эту строку.
- Статус доступности: маршрут активен, деградирован, неизвестен, в preview, ранний доступ, устаревший или скоро появится.
- Единица цены: тарификация за 1 млн input/output токенов, cached tokens, изображение, секунду, запрос, символ, минуту или другую единицу.
- Подтверждение использования: появляется ли ваш тестовый запрос в логах с ожидаемой моделью, статусом, количеством токенов, маршрутом, ключом и стоимостью.
Короткий ответ в этом Руководстве по каталогу AI-моделей: как читать провайдеров, эндпоинты, группы и цены таков: не выбирайте модель только по столбцу цены. Выбирайте её после того, как провайдер, эндпоинт, группа, статус, единица цены и подтверждение в логах использования совпадут с вашей нагрузкой.
Текущий снимок каталога моделей Flatkey
Текущая документация Flatkey описывает один базовый URL, совместимый с OpenAI, https://router.flatkey.ai/v1, а также API-эндпоинты для chat completions, Responses, embeddings, генерации изображений, задач с видео и списка моделей. Эндпоинт /v1/models возвращает ID моделей и провайдеров в формате, совместимом с OpenAI, а публичный каталог моделей — это актуальное место для просмотра цен, состояния здоровья, поддержки эндпоинтов и страниц с деталями моделей.
14 сентября 2026 года публичный каталог моделей Flatkey показывал поля строк, которые напрямую важны для проверки каталога:
| Поле каталога | Что оно сообщает | Примеры значений, наблюдаемых в публичном каталоге |
|---|---|---|
model_name |
Строка или строка модели, которую нужно протестировать. | gpt-5.6-sol, deepseek-v4-pro, seedance-2.5, gemini-3-flash-preview, claude-sonnet-5 |
vendor_name |
Провайдер или владелец каталога, стоящий за маршрутом. | OpenAI, DeepSeek, ByteDance, Google, Anthropic, каталог Flatkey |
supported_endpoint_types |
Какую форму запроса может принимать модель. | openai, openai-response, anthropic, gemini, openai-video, video |
availability_status |
Насколько данный маршрут сейчас, по-видимому, пригоден к использованию. | available, unknown_failure |
display_pricing.billing_kind |
Тип единицы цены. | token, per_second, request |
enable_groups / групповое ценообразование |
Какой маршрут или коммерческая группа может вызывать эту строку и как корректируется её цена. | Сгруппированные записи маршрутов, такие как plg в данных публичной страницы |
Рассматривайте этот снимок как доказательство того, как устроен каталог, а не как постоянную таблицу цен. В справочной документации Flatkey читателям прямо указывают на flatkey.ai/models, flatkey.ai/pricing и flatkey.ai/status, чтобы строки моделей, цены и состояние могли обновляться без выпуска новой версии документации.
Сначала читайте провайдеров, а уже потом названия моделей
Провайдер — это первое поле, потому что одно только название модели не говорит вам, куда идет трафик, какой контракт применяется и какие операционные ограничения важны.
Используйте поле провайдера, чтобы ответить на вопросы:
| Вопрос | Почему это важно |
|---|---|
| Управляется ли этот маршрут исходным провайдером модели, шлюзом, облаком для инференса или внутренним прокси? | Это влияет на поддержку, цены, логирование, обработку данных и ответственность за инциденты. |
| Представляет ли строка официальный endpoint или переобслуживаемую модель? | Продуктовым командам нужно знать, должно ли поведение совпадать с официальным API провайдера. |
| Есть ли несколько строк с похожими названиями от разных провайдеров? | Метка qwen, deepseek, gemini или claude может скрывать региональные различия, различия совместимости или тарифных планов. |
| С каким провайдером должна сверяться финансовая служба? | Единица биллинга и ссылка на базовую цену могут поступать от провайдера, тогда как счет может выставляться через шлюз. |
Для Flatkey утвержденная позиция — один ключ, один баланс и официальный доступ к моделям у провайдеров вроде OpenAI, Anthropic, Google, DeepSeek, Alibaba, Z.ai, Moonshot и ByteDance. Это делает прозрачность провайдера особенно важной. Если строка каталога не дает четко понять провайдера и класс маршрута, попросите разъяснение, прежде чем утверждать строку для продакшена.
Читайте endpoints как контракты, а не как метки
Поддержка эндпоинтов — это контракт между вашим приложением и маршрутом. Она определяет, сможет ли ваш текущий клиент, тело запроса, обработчик стриминга, парсер tool-call и логика учета использования работать без переписывания.
В REST-документации Flatkey перечислены следующие публичные API-эндпоинты:
| Эндпоинт | Типичное использование |
|---|---|
/v1/chat/completions |
Совместимые с OpenAI чат и генерация текста |
/v1/responses |
Состояние-сохраняющие или поддерживающие инструменты рабочие процессы в стиле Responses для совместимых моделей |
/v1/embeddings |
Векторные эмбеддинги |
/v1/images/generations |
Генерация изображений |
/v1/videos |
Создание задачи генерации видео |
/v1/videos/{task_id} |
Опрос задачи видео |
/v1/videos/{task_id}/content |
Загрузка завершенного видео |
/v1/models |
Список моделей, доступных аккаунту |
Строка каталога, где указано openai, — это не то же самое, что строка, где указано anthropic, gemini, openai-response, openai-video или video. Модель может поддерживать больше одной семейства эндпоинтов, но вам все равно нужно протестировать точный путь, который будет использовать ваше приложение.
Для этого руководства по каталогу AI-моделей используйте поле endpoint, чтобы составить краткий контракт совместимости:
catalog_endpoint_contract:
workload: support_ticket_summary
model_id: selected-model-id
provider: provider-name
endpoint_type: openai
base_url: https://router.flatkey.ai/v1
endpoint_path: /v1/chat/completions
required_features:
- streaming
- tool_calls
- structured_json
- usage_fields
pass_condition:
- existing_sdk_initializes
- response_parser_accepts_output
- usage_log_matches_model
- fallback_policy_is_documented
Если один пункт в этом контракте не выполняется, модель все еще может быть полезной, но она не является маршрутом plug-and-play для этой рабочей нагрузки.
Читать группы как политику маршрута и стоимости
Группы легко пропустить, потому что они выглядят как внутренние метки платформы. Не пропускайте их. Группа может определять, кто может использовать маршрут, какой коэффициент цены применяется, какой ключ разрешен, какая квота расходуется и какой пул fallback доступен.
В каталоге gateway группы часто представляют одну или несколько из этих политик:
| Значение группы | Что проверить |
|---|---|
| Коммерческий план | Имеет ли этот аккаунт или команда доступ к указанной цене? |
| Пул маршрутов | Какой класс upstream-канала или аккаунт провайдера обрабатывает трафик? |
| Среда продукта | Одобрен ли этот маршрут для dev, staging, production или конкретного клиента? |
| Область бюджета | С какого ключа, команды, workspace или бюджета клиента списывается оплата? |
| Allowlist | Разрешена ли модель для регулируемых данных, публичных функций или автономности агента? |
| Семейство fallback | Может ли эта группа перейти на другой маршрут без нарушения качества или политики? |
Позиционирование продукта Flatkey включает управление субключами, бюджеты, allowlist моделей, журналы использования и общий баланс. Это означает, что строка в каталоге и панель использования должны совпадать. Если продукт-менеджер одобряет модель в каталоге, но production-ключ не входит в нужную группу, инженеры обнаружат проблему как 403, 429, промах fallback или сюрприз в биллинге.
Сначала читайте цены по единицам, прежде чем сравнивать строки
Цена — это поле каталога моделей, которое чаще всего читают неправильно. Руководство по каталогу AI-моделей должно заставлять приводить каждую цену к ее реальной единице измерения, прежде чем кто-либо начнет сравнение.
Не сравнивайте эти единицы так, будто они одинаковы:
| Единица цены | Типичная рабочая нагрузка | Риск при анализе каталога |
|---|---|---|
| Input tokens | Чат с упором на промпт, суммаризация, генерация с дополнением извлечением | Длинные промпты и извлеченный контекст могут доминировать в стоимости. |
| Output tokens | Рассуждения, написание текста, генерация кода, извлечение | Длинные ответы могут доминировать в стоимости, даже если ввод кажется дешевым. |
| Cached input tokens | Повторно используемые системные промпты, кэширование промптов, кэширование контекста | Показатели cache-hit и cache-miss нужно измерять отдельно. |
| Image output tokens or per-image price | Генерация и редактирование изображений | Разрешение, качество, референсные изображения, повторы и доля принятых результатов меняют реальную стоимость. |
| Per second | Генерация видео и некоторые медиа-маршруты | Длительность и неудачные/отредактированные клипы важнее, чем количество запросов. |
| Per request | Поиск, инструменты, утилиты для изображений, обогащение данных, кастомные API | Итоговую стоимость определяют успешность запросов и политика повторных попыток. |
| Per minute or character | Речь, транскрибация, преобразование текста в речь, рабочие процессы типа OCR | Количество каналов, язык, дополнительные опции и пакетный режим могут менять стоимость. |
Страницы с ценами у провайдеров также используют разную терминологию. OpenAI, Anthropic, Google Gemini и DeepSeek в своей текущей публичной документации по ценам по-разному разделяют комбинации input, output, cached input, cache read/write или cache-hit/cache-miss pricing. Поэтому при анализе каталога следует сохранять живой URL источника и дату проверки вместо того, чтобы копировать одну постоянную цену в задачу дорожной карты.
Используйте эту нормализованную формулу:
accepted_workload_cost =
(primary_attempt_cost
+ retry_cost
+ fallback_cost
+ cached_or_uncached_delta
+ media_or_tool_addons)
/ accepted_outputs
Затем добавьте контекст принятия решения:
production_cost_decision =
accepted_workload_cost
+ latency_penalty
+ manual_review_cost
+ incident_risk
+ data_policy_constraints
Именно поэтому самая дешевая ячейка с ценой редко является окончательным ответом.
Сначала читайте статус, потом пускать ли производственный трафик
Статус доступности должен быть фильтром, а не сноской. Модель может выглядеть идеально по провайдеру, эндпоинту и цене, но все равно быть неправильным выбором для продакшена, если она доступна только в preview, деградирована, ограничена регионом, устарела, отсутствует в вашем аккаунте или не проходит health checks.
Используйте эти классы статуса:
| Класс статуса | Что делать |
|---|---|
| Доступно и протестировано | Кандидат на контролируемый rollout после проверки журналов использования. |
| Доступно, но не протестировано | Перед назначением производственного трафика выполните smoke test. |
| Preview, beta, early access или limited | Используйте для экспериментов, если только продукт явно не принимает риск жизненного цикла. |
| Снижена производительность или высокая задержка | Оставляйте как неосновной или запасной вариант только если нагрузка это допускает. |
| Неизвестный сбой | Считайте заблокированным, пока маршрут не будет проверен. |
| Устарело или запланировано отключение | Не начинайте новые работы, если только нет краткосрочной причины для миграции. |
| Скоро появится | Не включайте в обязательства по запуску. |
В документации Flatkey проверки состояния модели направляются на живую страницу статуса. Для производственного решения поле статуса следует сохранять вместе с датой, ID модели, типом эндпоинта, ключом или группой и одним реальным ID запроса.
Рабочий процесс Flatkey для проверки каталога
Используйте этот workflow каждый раз, когда продуктовая команда спрашивает, безопасно ли использовать модель из каталога.
- Откройте Flatkey Model Directory.
- Ищите точный ID модели, а не только название провайдера.
- Запишите провайдера, поддержку эндпоинтов, статус доступности, единицу тарификации, доступ к группе и текущую дату проверки.
- Откройте Flatkey pricing и соответствующую страницу цен провайдера.
- Запишите нормализованную единицу стоимости: за 1 млн входных токенов, выходных токенов, кэшированных токенов, изображение, секунду, запрос или другую единицу.
- Запустите низкорисковый smoke test через предполагаемые
base_url, путь эндпоинта и ID модели. - Подтвердите, что запрос появился в журналах использования Flatkey с ожидаемыми моделью, ключом, статусом, количеством токенов или медиа-единицей и стоимостью.
- Определите правила fallback до отправки реальных пользователей: триггер, количество повторов, разрешенные fallback-модели, quality gate и поля логирования.
- Перед тем как сделать маршрут основным, проверьте запись каталога вместе с продуктом, инженерами, финансами и службой безопасности.
Самое важное — шаг 7. Строка каталога — это обещание. Строка в журнале использования — это доказательство того, что обещание совпало с вашим аккаунтом, ключом, группой и рабочей нагрузкой.
Шаблон: запись проверки каталога AI-моделей
Скопируйте этот шаблон во внутренний документ запуска:
ai_model_catalog_review:
review_date: 2026-09-14
reviewer: product_owner_or_platform_owner
workload: customer_support_summary
business_owner: support_product
environment: staging
catalog:
catalog_url: https://flatkey.ai/models
model_id: selected-model-id
provider: provider-name
endpoint_types:
- openai
group_or_plan: approved-group
availability_status: available
pricing_unit: per_1m_input_and_output_tokens
compatibility:
base_url: https://router.flatkey.ai/v1
endpoint_path: /v1/chat/completions
sdk: openai-python
streaming_required: true
tool_calls_required: false
structured_output_required: true
cost:
provider_pricing_url: provider-pricing-page
flatkey_pricing_url: https://flatkey.ai/pricing
cost_formula: accepted_workload_cost
cache_assumption: measured_not_assumed
evidence:
smoke_test_request_id: req_example
usage_log_verified: true
output_parser_passed: true
p95_latency_ms: measured
fallback_tested: false
decision:
status: approve_for_limited_rollout
rollout_limit: 5_percent_of_traffic
fallback_route: selected-fallback-model
next_review_date: 2026-09-21
Этот шаблон делает руководство по каталогу AI-моделей: как читать провайдеров, эндпоинты, группы и цены — практичным. Результат — не список предпочтений. Это проверяемая запись о принятом решении.
Распространённые ошибки в каталоге AI-моделей
Ошибка 1: Считать провайдера и семейство модели одним и тем же полем
Провайдер — это внешний владелец или владелец маршрута. Семейство модели — это группа в наименовании. Они связаны, но не взаимозаменяемы. Записывайте оба.
Ошибка 2: Предполагать, что OpenAI-compatible означает работоспособность каждого эндпоинта
Настройка совместимости с OpenAI может сократить объём миграции, но она не доказывает, что для каждой модели будут работать любой эндпоинт, событие стриминга, форма tool-call, поле usage или параметр media. Проверяйте точную семейство эндпоинтов в строке каталога.
Ошибка 3: Сравнивать цену токенов с ценой медиа
Тарификация по токенам, по изображениям, по секундам и по запросам не должна сводиться к одному столбцу цены. Нормализуйте стоимость до цены за принятый результат для данной нагрузки.
Ошибка 4: Игнорировать группы до момента выката
Если production-ключу не разрешено вызывать группу, которую вы одобрили, решение по каталогу является неполным. Проверьте доступ к группе с тем ключом, который действительно будет использоваться в продакшене.
Ошибка 5: Копировать строку цены без даты пересмотра
Цены провайдера и шлюза могут меняться. Сохраните исходный URL, дату пересмотра, ID модели, единицу тарификации и подтверждение из логов использования по тестовому запросу.
Ошибка 6: Выпускать в продакшен, опираясь только на статус в каталоге
Статус в каталоге должен запускать smoke test. Он не должен заменять smoke test. Для одобрения в продакшен нужен как минимум один запрос через тот же ключ, эндпоинт, модель и группу.
Когда единый каталог AI-моделей особенно полезен
Единый каталог моделей особенно полезен, когда у команды есть больше чем одна из этих проблем:
- Несколько ключей провайдеров разбросаны по сервисам, агентам и средам.
- Продукту нужно сравнивать маршруты для текста, изображений, видео, эмбеддингов и инструментов в одном рабочем процессе.
- Финансам нужны доказательства стоимости на уровне запросов, а не отдельные счета от провайдеров.
- Платформенная инженерия нуждается в правилах fallback, проверках здоровья и allowlist'ах моделей.
- Безопасности нужно знать, какой маршрут обслужил какую рабочую нагрузку.
- Командам нужно переходить с одной модели на другую без переписывания каждого клиента.
Flatkey позиционируется именно под этот сценарий: один API-ключ, один роутер, совместимый с OpenAI, живой каталог моделей, журналы использования, доступ к моделям и инструментам через один баланс и операционные controls для команд. Это не отменяет должной проверки. Это даёт команде одно место, где её проводить.
FAQ
Что такое каталог AI-моделей?
Каталог AI-моделей — это доступный для поиска список маршрутов моделей и их метаданных: ID модели, провайдер, поддерживаемые эндпоинты, единица цены, доступность, группы или планы, а иногда окно контекста, модальность, состояние здоровья, лимиты и ссылки на использование.
Почему поле provider имеет значение?
Поле provider показывает, кто владеет исходной моделью или маршрутом. Оно влияет на поддержку, ценовые ориентиры, лимиты, уведомления о жизненном цикле, поведение по регионам, обработку данных и реагирование на инциденты.
Что означает поддержка endpoint в каталоге моделей?
Поддержка endpoint показывает, какой формат API принимает строка модели. Например, строка может поддерживать совместимые с OpenAI chat, Responses, совместимые с Anthropic запросы, нативные запросы Gemini, генерацию изображений, генерацию видео или embeddings. Ваш SDK и парсер должны соответствовать выбранному endpoint.
Группы — это то же самое, что и ценовые уровни?
Иногда да, но не всегда. Группы могут обозначать коммерческие планы, пулы маршрутов, политики доступа, области действия ключей, бюджетные области или семейства fallback. Рассматривайте группы как политику маршрута, пока владелец платформы не подтвердит точное значение.
Как командам сравнивать цены моделей?
Сравнивайте цены моделей по рабочей нагрузке, а не по сырой строке каталога. Нормализуйте входные токены, выходные токены, кэшированные токены, изображения, секунды, запросы, повторы, попытки fallback и принятые результаты в единую формулу стоимости.
Стоит ли доверять строке каталога моделей без тестирования?
Нет. Строка каталога — полезная отправная точка, но approval для production должен включать один smoke test через точный ключ, base URL, endpoint, ID модели и группу, которые вы планируете использовать.
Как Flatkey помогает при проверке каталога моделей?
Flatkey даёт командам одно место, где можно проверить строки моделей, направить трафик через base URL, совместимый с OpenAI, сравнить актуальные ценовые поверхности, проверить здоровье модели и просмотреть журналы использования. Это упрощает аудит решений по каталогу для продукта, инженерии и финансов.
Финальный шаг проверки каталога
Последний шаг в Руководстве по каталогу AI-моделей: как читать провайдеров, эндпоинты, группы и цены — это не выбор модели. Это доказательство маршрута.
Перед запуском ваша команда должна уметь показать:
- Точный ID модели и провайдера.
- Тип endpoint и путь SDK.
- Группу или план, которые дают доступ.
- Текущую единицу цены и URL источника.
- Статус доступности и дату проверки.
- ID smoke-test запроса.
- Строку в журнале использования, показывающую модель, ключ, статус, токены или единицу медиа и стоимость.
- Правило fallback и отката.
Если эти поля заполнены, каталог выполняет свою работу. Если их нет, выбор модели по-прежнему остается лишь предположением.
