Skip to content
Lumean API

Descriptions are in English

The section interface is translated into your language, but descriptions of operations, schemas and errors exist only in Russian and English — the English version is shown here.
GET/ai/models

Current AI model prices

Модели AI API (https://api.lumean.app/v1) и их текущие цены в LUMC.

any key

Цены меняются — поставщики дорожают и дешевеют, модель может временно пропасть. Проверяйте цену перед дорогой генерацией и сравнивайте со своим порогом; заранее зафиксировать её нельзя.

  • price.<класс>.per_mtok_minor — за 1M токенов (input, cached_input, output, reasoning, cache_write); price.request.per_call_minor — за вызов (картинки). Реальное значение — minor / 10^asset.precision, готовое — *_formatted.
  • *_display — та же ставка в валюте display_currency (заголовок X-Display-Currency, иначе валюта аккаунта), справочно; null — курса нет. Списание — в LUMC.
  • price: null или billing_available: false — модель сейчас платно не вызвать.
  • version и заголовок ETag меняются при любом изменении цен. Повторный запрос с If-None-Match: <ETag> отвечает 304 без тела, пока цены прежние.

Списание идёт по цене на момент запроса; от неожиданного роста трат защищает месячный лимит ключа (ai_monthly_limit_minor).

Права ключа не нужны — подходит любой активный ключ.

On this page(2)

Possible responses

200

Success. The payload is in data.

Body example
{
  "success": true,
  "message": "string",
  "data": {
    "version": "string",
    "models": [
      {
        "key": "string",
        "name": "string",
        "family": "string",
        "kind": "string",
        "description": "string",
        "context_window": "string",
        "max_output_tokens": "string",
        "capabilities": "string",
        "pricing_mode": "string",
        "price": {
          "key": {
            "per_mtok_minor": 1,
            "per_mtok_formatted": 1
          }
        },
        "billing_available": true,
        "byok": "string"
      }
    ],
    "asset": {
      "id": 1,
      "code": "string",
      "kind": "money",
      "precision": 1,
      "name": null,
      "is_active": true,
      "is_default": true,
      "default_balance": 1,
      "deleted_at": "2026-07-17T12:34:56+00:00",
      "created_at": "2026-07-17T12:34:56+00:00",
      "updated_at": "2026-07-17T12:34:56+00:00"
    },
    "display_currency": {
      "code": "string",
      "symbol": "string",
      "precision": 1,
      "available": true
    }
  }
}
Response fields
successrequired

Success flag. Branch on the HTTP status code instead: any 2xx response carries true here, while an error comes back in a different shape that need not contain this field at all.

boolean
messagerequired

A human-readable note in the account language. Fine to show to a user; do not parse it — the wording changes without notice and is not an error code.

string
datarequired

The response payload.

object
versionrequired
string
modelsrequired
array<AiGatewayCatalogModel>AiGatewayCatalogModel
array item
keyrequired

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

string
namerequired
string
familyrequired
string
kindrequired

chat | image. Модель image зовут через /v1/images (или чатом — ответ придёт markdown-картинкой), цена — price.request.

string
descriptionrequired
nullable
string
context_windowrequired
string
max_output_tokensrequired
string
capabilitiesrequired
string
pricing_moderequired
string
pricerequired

null — отпускной нет: ни одна пара не продаёт модель не в минус. Нули здесь обещали бы бесплатную модель.

nullable
object
*optional
claves arbitrarias
object
billing_availablerequired

Вызываема ли модель платным ключом. false при живой модели — она видна ради своего ключа (BYOK), а платный вызов откажет.

boolean
byokrequired
string
assetrequired
AssetAsset
idrequired

Internal identifier of the asset.

integer
coderequired

Asset code: LUMC is the internal currency, TOKEN the generation tokens.

string
kindrequired

Kind of asset: money or consumable units. It decides whether an amount counts as a payment or as quota consumption.

Valuesmoneyunit
AssetKindAssetKind
precisionrequired

Number of decimal places. The load-bearing field: every integer amount in this asset is divided by 10^precision to obtain the real value. Do not assume the divisor is 100.

integer
namerequired

Display name of the asset, in the account language.

string
deleted_atrequired

When the asset was retired, ISO 8601. null while it is in use.

nullabledate-time
string
created_atrequired

When the asset was created, ISO 8601.

nullabledate-time
string
updated_atrequired

When the asset last changed, ISO 8601.

nullabledate-time
string
display_currencyrequired
object
coderequired
string
symbolrequired
nullable
string
precisionrequired
integer
availablerequired
boolean
304

Цены не изменились с переданного ETag

Body example
"string"
401

The key is missing, unknown, disabled or expired.

Analyse this response
Body example
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Response fields
successrequired

Always false in error responses.

boolean
messagerequired

Error text in the key's language (set through the X-Locale header).

string
datarequired

Always null when the request is rejected before processing.

nullable
null

Nearby

The same in words

Neighbouring operations

Feed this page to an AI

Open .mdllm.md

spec 0.0.1