Zum Inhalt
Lumean API

Beschreibungen auf Englisch

Die Oberfläche des Bereichs ist in Ihre Sprache übersetzt, Beschreibungen von Operationen, Schemata und Fehlern gibt es aber nur auf Russisch und Englisch — hier wird die englische Fassung angezeigt.
GET/ai/models

Current AI model prices

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

beliebiger Schlüssel

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

  • 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).

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

Auf dieser Seite(2)

Mögliche Antworten

200

Success. The payload is in data.

Beispiel für den Body
{
  "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
    }
  }
}
Felder der Antwort
successerforderlich

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
messageerforderlich

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
dataerforderlich

The response payload.

object
versionerforderlich
string
modelserforderlich
array<AiGatewayCatalogModel>AiGatewayCatalogModel
Array-Element
keyerforderlich

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

string
nameerforderlich
string
familyerforderlich
string
kinderforderlich

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

string
descriptionerforderlich
darf null sein
string
context_windowerforderlich
string
max_output_tokenserforderlich
string
capabilitieserforderlich
string
pricing_modeerforderlich
string
priceerforderlich

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

darf null sein
object
*optional
beliebige Schlüssel
object
billing_availableerforderlich

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

boolean
byokerforderlich
string
asseterforderlich
AssetAsset
iderforderlich

Internal identifier of the asset.

integer
codeerforderlich

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

string
kinderforderlich

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

Wertemoneyunit
AssetKindAssetKind
precisionerforderlich

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
nameerforderlich

Display name of the asset, in the account language.

string
deleted_aterforderlich

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

darf null seindate-time
string
created_aterforderlich

When the asset was created, ISO 8601.

darf null seindate-time
string
updated_aterforderlich

When the asset last changed, ISO 8601.

darf null seindate-time
string
display_currencyerforderlich
object
codeerforderlich
string
symbolerforderlich
darf null sein
string
precisionerforderlich
integer
availableerforderlich
boolean
304

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

Beispiel für den Body
"string"
401

The key is missing, unknown, disabled or expired.

Diese Antwort analysieren
Beispiel für den Body
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Felder der Antwort
successerforderlich

Always false in error responses.

boolean
messageerforderlich

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

string
dataerforderlich

Always null when the request is rejected before processing.

darf null sein
null

In der Nähe

Dasselbe in Worten

Benachbarte Operationen

Diese Seite einer KI geben

.md öffnenllm.md

Spezifikation 0.0.1