Каталог моделей и их цены

Прочитайте, какие модели может назвать запрос и по какой цене каждая из них считается сейчас.

Каталог моделей — это список моделей, стоимость которых Slen умеет считать. По нему считается каждая оценка и каждый холд вызова модели. Через API каталог доступен только для чтения, а консоль показывает его на экране Модели.

Что в списке

Ответ перечисляет все активные модели, у которых в момент запроса есть действующая цена, в порядке model_code. Модель без действующей цены в список не попадает.

Каталог один для всех проектов: список не зависит от того, каких провайдеров подключил проект. Он не делится на страницы, поэтому в ответе нет meta.

model_code — это имя, которым узел AI-модель называет модель. Вызов модели, которой нет в каталоге или которую в нём выключили, отклоняется с кодом model_not_allowed, и выполнение заканчивается failed. Для активной модели без действующей цены код — cost_calculation_failed.

Как записана цена

Цена указана за миллион токенов, в валюте, которую называет currency. input_price_per_million и output_price_per_million есть всегда. cached_input_price_per_million равно null у модели, у которой нет отдельной цены на кешированные входные токены.

Цена — это версия. model_price_id называет действующую версию, а effective_from и effective_to ограничивают время, когда она применяется. effective_to равно null, пока у версии нет конца. Холд хранит версию, по которой он был посчитан, поэтому более позднее изменение цены не меняет стоимость более раннего запроса.

Операции

Описания операций и полей приведены на английском.

Доступные модели с действующими ценами

GET /v1/models

Разрешение: read

Ответы

200

Price snapshots effective at this instant

application/json

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "74438200973594624",
      "input_price_per_million": "0.02700000",
      "output_price_per_million": "0.02700000",
      "cached_input_price_per_million": "0.02700000",
      "max_output_tokens": 1,
      "currency": "USD",
      "effective_from": "2026-10-02T09:30:00Z",
      "effective_to": "2026-10-02T09:30:00Z"
    }
  ]
}

Ошибки

Статус	Коды	Когда
401		No credential, or one that is not valid
403		Authenticated, but not allowed: scope (`insufficient_scope`), policy or tenant (`not_a_member`); a blocked end customer (`customer_blocked`); an act only a signed-in person may take (`session_required`); the role rule on members and invitations (`member_forbidden`, `invite_forbidden`); a write to the organization's own rows, or a read of the audit journal, by a caller that does not reach every project (`project_access_restricted`)

Заголовки

X-Request-Id

Тело каждой ошибки — конверт ошибки.

Примеры

Получить список моделей

Ответ здесь сокращён до одной модели.

Terminal

curl https://api.slen.ai/api/v1/models \
  -H "Authorization: Bearer $SLEN_API_KEY"

200 OK

{
  "data": [
    {
      "model_code": "gpt-4o-mini",
      "provider": "openai",
      "model_price_id": "1108",
      "input_price_per_million": "0.15000000",
      "output_price_per_million": "0.60000000",
      "cached_input_price_per_million": "0.07500000",
      "max_output_tokens": 16384,
      "currency": "USD",
      "effective_from": "2026-01-01T00:00:00+00:00",
      "effective_to": null
    }
  ]
}

Что читать дальше

Модели и цены — тот же каталог в консоли.
Обзор — как в ответе записываются деньги.
Аутентификация — разрешение, которое нужно ключу, чтобы читать каталог.
Коды ошибок — каждый код API — что он значит и что делать.

Собрано из openapi b070e1f, sdk contract 5cc7055, php ae4a53b, node 84bc62d