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

Deployment Usage

GET
/v1/deployments/{deployment_id}/usage
curl --request GET \
  --url https://api.cloud.agentums.ru/v1/deployments/2489E9AD-2EE2-8E00-8EC9-32D5F69181C0/usage \
  --header 'Authorization: Bearer <token>'

Сколько потратила машина агента за текущий месяц.

Маршрут был отложен честно: пока агент ходил в модель мимо нас, самая крупная статья его трат проходила мимо учёта целиком, и отчёт выглядел бы правдоподобно, оставаясь враньём. Теперь агент ходит через нашу дверь, и считать стало что.

!!! warning “Это расход на модель и обработку, а не полная стоимость машины” Сама VM у провайдера стоит отдельно и в эти числа НЕ входит. Почасового учёта провайдерского счёта по машинам мы не ведём, а выводить его из тарифа нельзя: остановленная машина стоит иначе, чем работающая, и цены провайдер меняет без нашего участия. Складывать одно с другим — работа биллинга, и делать это молча здесь значило бы однажды показать сумму, которой никто не выставлял.

Разбивка по видам работы отдаётся вместе с итогом: «агент потратил 40 ₽» не отвечает на вопрос, почему, а «38 ₽ модель и 2 ₽ поиск» — отвечает.

Authorizations

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

Parameters

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

Path Parameters

Заголовок раздела «Path Parameters»
deployment_id
required
Deployment Id
string format: uuid

Responses

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

200

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

Successful Response

Media typeapplication/json
DeploymentUsageOut

Сколько потратила машина агента за текущий месяц.

!!! Это расход на МОДЕЛЬ и обработку. Сама VM у провайдера стоит отдельно, и в cost_rub её НЕТ: почасового учёта провайдерского счёта по машинам мы не ведём, а сложить одно с другим значило бы показать сумму, которой никто не выставлял.

Цена тарифа при этом называется — отдельным полем, и это уточнение прежнего решения, а не отказ от него. Раньше её здесь не было вовсе по доводу «выводить стоимость из тарифа нельзя». Довод верен для СУММЫ и неверен для самого тарифа: число machine_plan_rub человек уже видел, когда выбирал машину («от 992 ₽/мес»), и умолчание о нём на экране расходов никого не бережёт — оно заставляет гадать, все ли это траты. Сорок рублей за модель без единого слова про машину читаются как полная картина, и это худшее враньё из двух.

object
by_meter
By Meter
Array<object>
MeterSpendOut

Расход по одному виду работы: модель, поиск, расшифровка.

object
calls
required
Calls
integer
cost_rub
required
Cost Rub
number
meter
required
Meter
string
total_tokens
required
Total Tokens
integer
cached_tokens
Cached Tokens
integer
0
calls
Calls
integer
0
cost_rub
Cost Rub
number
0
deployment_id
required
Deployment Id
string format: uuid
machine_plan_rub
Any of:
number
messages_estimate
Any of:
integer
note
Note
string
default: Токены агента входят в пакет тарифа. Отдельно за агента ничего не списывается.
output_tokens
Output Tokens
integer
0
period_start
required
Period Start
string format: date-time
prompt_tokens
Prompt Tokens
integer
0
total_tokens
Total Tokens
integer
0
Example
{
  "cached_tokens": 0,
  "calls": 0,
  "cost_rub": 0,
  "note": "Токены агента входят в пакет тарифа. Отдельно за агента ничего не списывается.",
  "output_tokens": 0,
  "prompt_tokens": 0,
  "total_tokens": 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"
    }
  ]
}