Перейти к содержимому
Agentum Cloud для разработчиков

Usage Spend

GET
/v1/usage/spend
curl --request GET \
  --url 'https://api.cloud.agentums.ru/v1/usage/spend?month=' \
  --header 'Authorization: Bearer <token>'

Расход по СТАТЬЯМ за месяц: за что с человека списали деньги.

Не то же, что /v1/usage. Тот отвечает «сколько стоила работа модели» и разбивает расход по видам работы; здесь человек спрашивает другое — «за что с меня списали».

Тариф «всё включено» (27.09.2026): деньгами проходят подписка и докупка токенов, агенты и место для файлов — статьи «входит в тариф». charged_rub — только то, что списано; recurring_rub всегда ноль. Сравнение с прошлым месяцем — по списанному.

Authorizations

Заголовок раздела «Authorizations»

Parameters

Заголовок раздела «Parameters»

Query Parameters

Заголовок раздела «Query Parameters»
month
Month

ГГГГ-ММ; пусто — текущий месяц

string
"" <= 7 characters

ГГГГ-ММ; пусто — текущий месяц

Responses

Заголовок раздела «Responses»

200

Заголовок раздела «200»

Successful Response

Media typeapplication/json
SpendOut

Расход по статьям за месяц: из чего складывается счёт.

object
categories
Categories
Array<object>
SpendCategory

Одна статья расхода за месяц.

kind — в СХЕМЕ, а не подписью в вёрстке:

  • charged — деньги уже прошли (платёж, проводка);
  • included — входит в тариф и отдельно не стоит ничего (агенты, место для файлов).

recurring (цена машин, счёта по которой не выставлялось) с тарифа «всё включено» (27.09.2026) не бывает: агент входит в тариф.

object
amount_rub
Amount Rub
number
0
code
required
Code
string
hint
Hint
string
""
kind
Kind
string
default: charged
title
required
Title
string
charged_rub
Charged Rub
number
0
month
required
Month
string
period_start
required
Period Start
string format: date-time
previous_charged_rub
Any of:
number
recurring_rub
Recurring Rub
number
0
Example
{
  "categories": [
    {
      "amount_rub": 0,
      "hint": "",
      "kind": "charged"
    }
  ],
  "charged_rub": 0,
  "recurring_rub": 0
}

422

Заголовок раздела «422»

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}