API-пайплайн: ваши расходы на ИИ

Цель: увидеть, сколько стоит ИИ ваших оракулов и кампаний, по кампаниям и по оракулам, и сколько осталось на балансе.

Шаги

1. Расходы за период.

GET /v0/my/funds/ai-usage?from=2026-10-01&to=2026-10-15
→ {"currency": "USDT", "from": "2026-10-01T00:00:00+00:00", "to": "2026-10-15T00:00:00+00:00",
   "charged_usd": 4.12, "requests": 830, "tokens": 9100000,
   "by_campaign": [{"campaign": "<campaign>", "charged_usd": 3.5, "requests": 700, "tokens": 8000000}],
   "by_oracle": [{"oracle": "<oracle>", "charged_usd": 0.62, "requests": 130, "tokens": 1100000}], …}

2. Сколько осталось. GET /v0/my/funds/check-balance → {"balance": "31.00", "currency": "USDT", "available": "30.60", …}. available — сколько ваши оракулы и кампании ещё могут потратить.

Цена и списание

• Использование ИИ списывается с вашего баланса по цене провайдера + 18%. charged_usd — эта сумма; списания видны в истории операций как AI_USAGE.
• Когда баланс заканчивается, ваши оракулы и кампании встают на паузу, пока вы не пополните его: API-пайплайн: пополнение баланса через Telegram Stars, TON, USDT в сети TON или BTC

Правила

• from / to: RFC 3339 или YYYY-MM-DD (UTC); по умолчанию с начала месяца до текущего момента. Неверные значения → 400.
• campaign: null = ИИ вне ваших кампаний; oracle: null = ИИ, не привязанный к одному из ваших оракулов.
• Токен агенды или оракула → 404: у него нет собственных расходов.

Поверхность API

Индекс: API-пайплайны — индекс