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

GET/subscriptions

Возвращает сводку по подпискам владельца API-ключа.

billing.read

В ответе:

  • available_models — список ключей моделей, доступных пользователю;
  • subscriptions — только пригодные (живые) подписки: статус Active и срок не истёк. Истёкшие/просроченные и отменённые не возвращаются. По каждой: статус, признак is_usable, границы текущего периода и список items с планом, периодом, датой окончания (end_at) и остатком токенов (token_allowance / tokens_used / tokens_remaining).

Денежные данные (кошельки, баланс, цены) в публичном API не отдаются.

Требует право billing.read.

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

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

200

Сводка подписок и доступных моделей

Пример тела
{
  "success": true,
  "message": "Success",
  "data": {
    "available_models": [
      "gpt-4.1-mini",
      "claude-haiku-4.5"
    ],
    "subscriptions": [
      {
        "id": 301,
        "status": "active",
        "current_period_start": "2026-07-15T00:00:00+00:00",
        "current_period_end": "2026-08-15T00:00:00+00:00",
        "items": [
          {
            "plan": {
              "code": "creator",
              "name": "Creator"
            },
            "status": "active",
            "is_usable": true,
            "billing_period": "monthly",
            "start_at": "2026-07-15T00:00:00+00:00",
            "end_at": "2026-08-15T00:00:00+00:00",
            "token_allowance": 30000,
            "tokens_used": 8200,
            "tokens_remaining": 21800
          }
        ]
      }
    ]
  }
}
Поля ответа
successобязательное

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

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

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

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

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

object
available_modelsобязательное

Коды моделей, доступных по активным подпискам. Модель вне этого списка будет отклонена при создании заказа.

array<string>
subscriptionsобязательное

Ваши подписки. Пустой список — активной подписки нет: заказы возможны только при положительном балансе LMC.

array<object>
элемент массива
idобязательное

Идентификатор подписки.

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

Состояние подписки. Автопродления нет: по истечении срока подписка переходит в истёкшую, и тариф покупается заново.

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

Начало текущего периода, ISO 8601.

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

Конец текущего периода, ISO 8601 — момент, когда подписка истечёт.

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

Тарифы внутри подписки: что куплено и сколько токенов осталось.

array<object>
элемент массива
planобязательное

Купленный тариф: код и название.

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

Код тарифа.

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

Название тарифа для показа.

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

Состояние тарифа внутри подписки.

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

Можно ли расходовать этот тариф прямо сейчас. Ориентируйтесь на него, а не на status: тариф бывает активен формально, но уже исчерпан.

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

Период тарификации. Поддерживается только месячный.

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

Когда тариф начал действовать, ISO 8601.

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

Когда тариф истекает, ISO 8601. После этого момента остаток токенов сгорает.

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

Сколько токенов даёт тариф за период.

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

Сколько токенов израсходовано в текущем периоде.

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

Сколько токенов осталось. Именно этот остаток тратится до списания LMC — доплата включается, только когда он исчерпан.

integer
401

API-ключ отсутствует, неизвестен, неактивен или истёк

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "API key is missing. Provide it in the X-API-KEY header.",
  "data": null
}
Поля ответа
successобязательное

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

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

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

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

Всегда null, когда запрос отклонён до обработки.

может быть null
null
403

У ключа нет права billing.read

Разобрать этот ответ
Пример тела
{
  "success": false,
  "message": "This API key does not have permission to perform this action."
}
Поля ответа
successобязательное

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

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

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

string

Рядом

Об этом словами

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

Открыть .mdllm.md

спека 0.0.1