AIRUS Gateway
Войти

AIRUS MarginOps

GPUFinOps показал себестоимость собственных вычислений. Но полная экономика gateway сложнее: upstream API + курс + fallback + retries + локальный inference + инфраструктура + партнёрская комиссия + поддержка + SLA-компенсации + налоги. AIRUS рассчитывает contribution margin ДО отправки запроса provider, а не после закрытия месяца. AIRUS зарабатывает на прозрачном control plane, а не на скрытой наценке.

Что делает

Request Economics Ledger
Каждый запрос: customer revenue − upstream − FX − partner share − platform − SLA reserve = contribution margin. Маржа считается по фактическому resolved provider, а не по каталожной цене — иначе резервный route делает успешный запрос убыточным.
Price Floor Engine
Routing не выполнит запрос через provider, нарушающий утверждённый price floor. Отрицательная ожидаемая маржа → блок. Floor берётся из записанной Margin Policy, а не из запроса — обойти параметром нельзя.
Margin-aware Fallback + FX Protection
Fallback защищает SLA, но не убивает экономику: cost delta лимитирован, маржа проверяется. FX-буфер и versioned exchange-rate policy защищают фиксированную рублёвую цену от роста доллара между запросом и расчётом с provider.
Discount Guardrails + Gross Margin Receipt
Скидка ниже floor требует commit / minimum spend / approval — иначе добровольное уничтожение unit economics. Ежемесячный Gross Margin Receipt: revenue − fully-loaded cost → contribution margin, negative-margin клиенты.

Billable Event Matrix

Формальная политика, кто платит — без спора с клиентом:

  • Успешный ответ: клиент платит, AIRUS платит upstream.
  • Provider 5xx: клиент не платит, upstream обычно нет.
  • Client disconnect / content filter: по политике/договору (upstream мог вычислить).
  • Fallback success: клиент платит; AIRUS — за одну или несколько попыток.

Как использовать

# Economics + fallback + discount (public калькуляторы)
POST /v1/airus/margins/economics/preview { "customer_revenue_rub": 18.40, "upstream_cost_rub": 12.70, "partner_cost_rub": 1.10 }
POST /v1/airus/margins/fallback/check { "primary_cost_rub": 240, "fallback_cost_rub": 1100, "customer_revenue_rub": 1000, "floor_gross_margin": 0.18 }
POST /v1/airus/margins/discount/check { "resulting_margin_rate": 0.05, "floor_gross_margin": 0.18 }  # → нужен commit
POST /v1/airus/margins/fx-apply { "amount_usd": 100, "cb_rate": 76.6647, "buffer_percent": 2 }

# Margin policy + route-check (JWT) — floor из ЗАПИСАННОЙ policy
POST /v1/airus/margins/policies/route/external_reasoning { "minimum_gross_margin": 0.20 }
POST /v1/airus/margins/route-check { "route": "external_reasoning", "customer_revenue_rub": 100, "upstream_cost_rub": 90 }  # → block
POST /v1/airus/margins/economics { "request_ref": "req_1", "customer_revenue_rub": 18.40, "upstream_cost_rub": 12.70 }

Честно про слой

  • Движки детерминированы: request economics (contribution margin выводится из компонентов), price floor, margin-aware fallback, FX, discount guardrail, price lock reserve, anomaly, gross margin receipt.
  • Правила зашиты: price floor берётся из записанной Margin Policy (не из запроса — нельзя обойти); отрицательная маржа → block; скидка ниже floor без commit → блок.
  • v0 = финансовый framework: реальная интеграция в hot-path routing (блок по марже в реальном времени), импорт provider invoices + reconciliation, live FX feed — roadmap. Здесь — движки, реестры и receipts.
  • Discount Guardrail — публичный калькулятор: сейчас commit-флаг (annual commit / minimum spend / approval) принимается как вход «что если». В enforcement-версии он будет выводиться из записанного price-lock / commitment (уже храним min_commit), а не из булева в запросе — чтобы обход нельзя было задекларировать.
  • Дополняет, не дублирует: GPUFinOps (GPU cost как компонент), Price Anatomy, RouteEconomics. MarginOps считает МАРЖУ, баланс-ledger (append-only) не трогает.
Открыть MarginOpsGPUFinOpsMarginOps API