İçeriğe geç
Lumean API

Açıklamalar İngilizce

Bölümün arayüzü dilinize çevrildi, ancak işlem, şema ve hata açıklamaları yalnızca Rusça ve İngilizce mevcut — burada İngilizce sürüm gösteriliyor.
GET/ai/models

Current AI model prices

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

herhangi bir anahtar

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

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

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

Bu sayfada(2)

Olası yanıtlar

200

Success. The payload is in data.

Gövde örneği
{
  "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
    }
  }
}
Yanıt alanları
successzorunlu

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
messagezorunlu

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
datazorunlu

The response payload.

object
versionzorunlu
string
modelszorunlu
array<AiGatewayCatalogModel>AiGatewayCatalogModel
dizi öğesi
keyzorunlu

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

string
namezorunlu
string
familyzorunlu
string
kindzorunlu

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

string
descriptionzorunlu
null olabilir
string
context_windowzorunlu
string
max_output_tokenszorunlu
string
capabilitieszorunlu
string
pricing_modezorunlu
string
pricezorunlu

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

null olabilir
object
*isteğe bağlı
rastgele anahtarlar
object
billing_availablezorunlu

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

boolean
byokzorunlu
string
assetzorunlu
AssetAsset
idzorunlu

Internal identifier of the asset.

integer
codezorunlu

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

string
kindzorunlu

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

Değerlermoneyunit
AssetKindAssetKind
precisionzorunlu

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
namezorunlu

Display name of the asset, in the account language.

string
deleted_atzorunlu

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

null olabilirdate-time
string
created_atzorunlu

When the asset was created, ISO 8601.

null olabilirdate-time
string
updated_atzorunlu

When the asset last changed, ISO 8601.

null olabilirdate-time
string
display_currencyzorunlu
object
codezorunlu
string
symbolzorunlu
null olabilir
string
precisionzorunlu
integer
availablezorunlu
boolean
304

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

Gövde örneği
"string"
401

The key is missing, unknown, disabled or expired.

Bu yanıtı çözümle
Gövde örneği
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Yanıt alanları
successzorunlu

Always false in error responses.

boolean
messagezorunlu

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

string
datazorunlu

Always null when the request is rejected before processing.

null olabilir
null

İlgili içerik

Komşu işlemler

Bu sayfayı yapay zekâya verin

.md sürümünü açllm.md

spesifikasyon 0.0.1