Модели и каталог API
Начните с каталога. Сопоставьте задачу, входные и выходные данные, параметры и цену. В API передавайте externalId, например openai/gpt-5.
Публичный каталог
GET https://api.apikley.ru/models/summary доступен без API-ключа. Это отдельный адрес вне префикса /v1.
Получить страницу каталога
curl 'https://api.apikley.ru/models/summary?source=APIKLEY&page=1&pageSize=50&sort=recommended'| Параметр | Назначение и значение по умолчанию |
|---|---|
provider | Фильтр по провайдеру. |
author | Фильтр по автору модели. |
source | Источник цен; по умолчанию APIKLEY. |
includeDeprecated | По умолчанию false. Значение true включает устаревшие модели в чтение каталога. |
includeInvisible | По умолчанию false. Значение true не открывает скрытые модели публичному клиенту. |
sort | recommended или recently_added. Второй вариант относится к добавлению в каталог Apikley. |
page | Номер страницы; по умолчанию 1. |
pageSize | Размер страницы; по умолчанию 50. Сервер ограничивает его настроенным максимумом. |
Перебирайте страницы, ориентируясь на total и фактический pageSize в ответе.
Поля ответа
| Поле | Содержимое |
|---|---|
items | Массив моделей. |
total, page, pageSize | Общее число элементов и параметры страницы. |
deprecatedCount, deprecatedModels | Сведения об устаревших моделях. |
items[].id, items[].externalId | UUID каталога и внешний ID для inference соответственно. |
| Данные модели | Имя, автор, провайдер, модальности, задачи, размер контекста, признаки видимости и устаревания, цены и slug страницы. |
| Поля цен | source, billingUnit, priceRub, credits, creditToRubRate. Десятичные значения сериализуются строками. |
Каталог поддерживает ETag: передайте полученное значение в If-None-Match. При совпадении сервер возвращает 304; используйте ранее сохранённое тело.
Проверяйте статус модели
Скрытые модели исключены из публичной выдачи. Устаревшие по умолчанию тоже исключены. includeDeprecated=true не восстанавливает возможность запросов к устаревшей модели.
Наличие модели в каталоге не гарантирует доступность провайдера при каждом запросе. Обрабатывайте ошибки. Актуальные цены сверяйте в каталоге и разделе цен.
Частые вопросы
Что передавать в model?
Точное значение externalId, а не UUID id. Например: deepseek/deepseek-v4-flash.
Почему модель из каталога вернула model_deprecated?
Устаревшую модель можно получить с includeDeprecated=true, но inference отклоняет её с HTTP 400. Выберите другую модель.
Можно ли фильтровать summary по task?
Параметры task, billingUnit и includePricing относятся к /models; они не входят в контракт /models/summary.
Обновлено