AIKraft/AI/Войти
AIKraft/Skills/Оплата по использованию

Оплата по использованию

Guide for charging directly per measured API call, token, storage unit, or other consumption using meters, stable usage events, aggregation, free thresholds, and metered subscriptions.

dodopayments official Разработка

Что делает навык

Навык обеспечивает прямое взимание платы за измеренное потребление ресурсов (вызовы API, токены, хранилище) через систему счётчиков (meters), агрегацию событий и подписки. Он позволяет отслеживать использование, применять бесплатные пороги и тарификацию за единицу, интегрируя эти данные с подписками или одноразовыми покупками.

Когда применять

  • Тарификация пользователей за количество вызовов API или сгенерированных изображений.
  • Учет и оплата потребления AI-токенов (prompt и completion tokens) для сервисов на базе LLM.
  • Мониторинг и биллинг использования хранилища данных на основе снимков состояния (snapshot).
  • Интеграция метрического биллинга с существующими подписками или кредитными балансами.

Как работает

  1. Создать Meter (счётчик), указав event_name, тип агрегации (count, sum, max, last) и единицу измерения.
  2. Настроить Pricing, привязав Meter к цене за единицу (price_per_unit) и опциональному бесплатному порогу (free_threshold).
  3. Отправлять события использования (Events) через client.usageEvents.ingest, используя уникальные event_id для идемпотентности.
  4. Использовать outbox-паттерн для надежного сохранения событий перед их отправкой и обработки ошибок через повторные попытки.
  5. Запрашивать историю использования через client.subscriptions.retrieveUsageHistory для отображения или сверки данных.

Примеры запросов агенту

Создай счётчик для подсчета вызовов API с агрегацией по типу count и единицей измерения calls.
Отправь событие использования токенов для клиента cus_abc123 с именем события ai.tokens и метаданными о количестве токенов.
Получи историю потребления ресурсов по подписке sub_abc123 за текущий биллинговый период.

Что понадобится

  • Ключ API Dodo Payments (bearerToken) и настройка окружения (test_mode или production).
  • Установленный пакет dodopayments (DodoPayments client).
  • Наличие customer_id и корректно сформированных event_id для идемпотентности.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «usage-based-billing» из репозитория: # https://github.com/dodopayments/skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r usage-based-billing/ ~/.claude/skills/usage-based-billing/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.