К содержанию
Lumean API

GET/ai/models/{key}

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

любой ключ

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

На этой странице(3)

Параметры

Поля ввода живут прямо в строке запроса: подставьте значение — и получите готовый URL. Ниже — тип, обязательность и допустимые значения каждого параметра.

GEThttps://api.lumean.app/api/public/ai/models/
  • stringв путиобязательный

    Значение подставляется прямо в строку запроса выше.

Возможные ответы

200

Модель с текущей ценой

Пример тела
{
  "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"
    }
  }
}
Поля ответа
successобязательное

Признак успеха. Решение принимайте по HTTP-коду: у любого ответа 2xx здесь true, а ошибка приходит телом другой формы, где этого поля может не быть вовсе.

boolean
messageобязательное

Пояснение для человека, на языке аккаунта. Показать пользователю можно; разбирать программно — нет: формулировки меняются без предупреждения и кодом ошибки не являются.

string
dataобязательное

Полезная нагрузка ответа.

object
versionобязательное
string
modelsобязательное
array<AiGatewayCatalogModel>AiGatewayCatalogModel
элемент массива
keyобязательное

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

string
nameобязательное
string
familyобязательное
string
kindобязательное

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

string
descriptionобязательное
может быть null
string
context_windowобязательное
string
max_output_tokensобязательное
string
capabilitiesобязательное
string
pricing_modeобязательное
string
priceобязательное

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

может быть null
object
*необязательное
произвольные ключи
object
billing_availableобязательное

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

boolean
byokобязательное
string
assetобязательное
AssetAsset
idобязательное

Внутренний идентификатор актива.

integer
codeобязательное

Код актива: LUMC — внутренняя валюта, TOKEN — токены генерации.

string
kindобязательное

Вид актива: деньги или расходуемые единицы. От него зависит, где сумма считается платежом, а где — расходом квоты.

Значенияmoneyunit
AssetKindAssetKind
precisionобязательное

Число десятичных знаков. Ключевое поле: любая целая сумма этого актива делится на 10^precision, чтобы получить реальное значение. Не считайте, что делитель равен 100.

integer
nameобязательное

Название актива для показа, на языке аккаунта.

string
deleted_atобязательное

Когда актив выведен из обращения, ISO 8601. null у действующего.

может быть nulldate-time
string
created_atобязательное

Когда актив заведён, ISO 8601.

может быть nulldate-time
string
updated_atобязательное

Когда актив последний раз менялся, ISO 8601.

может быть nulldate-time
string
304

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

Пример тела
"string"
404

Модели нет в каталоге

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "Resource not found."
}
Поля ответа
successобязательное

Всегда false в ответах об ошибке.

boolean
messageобязательное

Текст ошибки на языке ключа (задаётся заголовком X-Locale).

string
reasonнеобязательное

Машиночитаемая причина — приходит у бизнес-отказов (например, invalid_order_status); у прочих ошибок поля нет. Ветвите обработку по нему, а не по тексту сообщения.

string
error_codeнеобязательное

Тот же машинный код, что в reason, — второе имя поля. Приходит вместе с reason, значения всегда совпадают.

string

Рядом

Соседние операции

Скормить страницу ИИ

Открыть .mdllm.md

спека 0.0.1