Skip to content
Lumean API
GET/ai/models/{key}

Current price of one AI model

Текущая цена одной модели по её key (то же имя, что в поле model запроса). Форма ответа та же, что у списка, — в models одна запись. ETag и If-None-Match работают так же. Модели нет или её сейчас нельзя вызвать — 404: не отправляйте генерацию, пока она не вернётся.

any key

Права ключа не нужны.

On this page(3)

Parameters

The inputs live inside the request line: fill in a value and you get a ready URL. Below are the type, whether it is required and the allowed values of every parameter.

GEThttps://api.lumean.app/api/public/ai/models/
  • stringin pathrequired

    The value goes straight into the request line above.

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"
    }
  }
}
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
arbitrary keys
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
304

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

Body example
"string"
404

Not found, or not reachable with this key.

Analyse this response
Body example
{
  "success": false,
  "message": "Resource not found."
}
Response fields
successrequired

Always false in error responses.

boolean
messagerequired

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

string
reasonoptional

Machine-readable reason — present on business refusals (for example, invalid_order_status); other errors omit it. Branch on it, not on the message text.

string
error_codeoptional

The same machine-readable code as in reason — a second name for the field. Arrives together with reason; the values always match.

string

Nearby

Neighbouring operations

Feed this page to an AI

Open .mdllm.md

spec 0.0.1