系統(tǒng):按使用付費(fèi)的完整指南)
如何用Lago快速搭建開源計量計費(fèi)系統(tǒng)按使用付費(fèi)的完整指南【免費(fèi)下載鏈接】lagoOpen Source Metering and Usage Based Billing API ?? Consumption tracking, Subscription management, Pricing iterations, Payment orchestration Revenue analytics項(xiàng)目地址: https://gitcode.com/GitHub_Trending/la/lago給 AI 產(chǎn)品按 token 收費(fèi)、給 API 按調(diào)用量收費(fèi)時自己攢一套計費(fèi)系統(tǒng)總?cè)菀自谥卦?、對賬上翻車。Lago 是開源計量計費(fèi)系統(tǒng)把使用量直接變成賬單和收款事件進(jìn)來金額出去。三分鐘跑起來 克隆倉庫git clone --depth 1 https://gitcode.com/GitHub_Trending/la/lago cd lago本地開發(fā)根目錄的 docker-compose.yml 會生成簽名密鑰、跑遷移然后拉起 API 和前端一條命令即可echo LAGO_RSA_PRIVATE_KEY\$(openssl genrsa 2048 | openssl base64 -A)\ .env docker compose up -d起好后瀏覽器打開 http://localhost 就是管理界面API 在 http://localhost:3000。生產(chǎn)部署用 deploy/ 下的配置。小流量選 docker-compose.light.yml帶 Traefik 反代和 Lets Encrypt大流量選 docker-compose.production.yml額外拆出計費(fèi)、Webhook、事件等獨(dú)立 Worker 便于擴(kuò)容docker compose -f deploy/docker-compose.production.yml up -d --profile all生產(chǎn)配置需要域名具體環(huán)境變量在 deploy/README.md 里都有說明。它是怎么工作的先建立直覺再上圖。整個鏈路一句話你的應(yīng)用把用量事件推給 APILago 按訂閱和定價規(guī)則算錢月底定時出賬再對接支付渠道收款。輸入事件流。比如這次 AI 調(diào)用消耗了 1200 個 input token通過 REST API 持續(xù)推送中間events-processor/ 消費(fèi)事件并聚合Redis 做隊列和緩存Postgres 存業(yè)務(wù)數(shù)據(jù)ClickHouse 存海量事件明細(xì)Kafka 承載事件流產(chǎn)出實(shí)時用量、發(fā)票、收款記錄。billing-worker 生成發(fā)票webhook-worker 把結(jié)果回調(diào)給你的業(yè)務(wù)系統(tǒng)時鐘進(jìn)程負(fù)責(zé)每月出賬這類定時任務(wù)。核心能力實(shí)操跑通一個 AI 計費(fèi)演示目的不用寫一行配置親眼看到事件 → 金額的完整鏈路。./examples/agentic-ai-demo/run.sh腳本會起一個獨(dú)立 Lago 實(shí)例建好客戶、兩個計量指標(biāo)輸入/輸出 token和一個按月訂閱發(fā)送 3 次 AI 請求對應(yīng)的 6 條 token 事件然后對賬并故意重發(fā)其中一條事件來證明不會重復(fù)計費(fèi)。預(yù)期輸出5,000 input tokens x $0.000002 $0.01 1,250 output tokens x $0.00008 $0.01 Lago usage total $0.02再打開 http://localhost:8080 登錄就能看到用量明細(xì)。玩完清理./examples/agentic-ai-demo/run.sh --cleanup。給真實(shí)業(yè)務(wù)發(fā)一條計量事件目的把你自己產(chǎn)品里的用量接進(jìn)來。{ event: { transaction_id: txn-unique-001, // 全局唯一重試不會重復(fù)計費(fèi) external_subscription_id: sub-001, code: input-tokens, // 對應(yīng)你建的計量指標(biāo) properties: { tokens: 1200 } } }用 API 密鑰 POST 到/events即可。預(yù)期結(jié)果界面里該訂閱的實(shí)時用量立刻增加對應(yīng)金額重復(fù)提交同一個transaction_id會被識別為冪等請求用量不漲。配置第一個定價規(guī)則目的定義按什么量、什么價收費(fèi)。UI 里創(chuàng)建Billable Metric計費(fèi)指標(biāo)選事件 code、取哪個字段、用什么聚合方式求和、去重計數(shù)等創(chuàng)建Plan Charge掛上指標(biāo)并填單價支持標(biāo)準(zhǔn)計費(fèi)、階梯、按量包、預(yù)付額度等模型。預(yù)期結(jié)果訂閱者掛上該計劃后每發(fā)一條事件用量金額就按規(guī)則實(shí)時累積到賬單周期自動出賬。進(jìn)階與定制Worker 獨(dú)立擴(kuò)容生產(chǎn)環(huán)境按環(huán)境變量開啟專用 Worker計費(fèi)、事件、Webhook、PDF 等高負(fù)載隊列互相隔離各自水平擴(kuò)副本詳見 docs/architecture.md監(jiān)控與告警Lago 暴露 Prometheus 指標(biāo)覆蓋 API、隊列深度和 Worker 積壓生產(chǎn)部署建議配上告警見 docs/monitoring.md數(shù)據(jù)庫分片事件量上來后如何分庫參考 docs/database_partitioning.md。更多細(xì)節(jié)去 docs/ 目錄包括開發(fā)環(huán)境搭建dev_environment.md和部署指南。寫在最后Lago 適合做按量計費(fèi)產(chǎn)品的團(tuán)隊SaaS、API 網(wǎng)關(guān)、AI 產(chǎn)品、云資源。它解決的是從事件接入、定價、出賬到收款對賬這條鏈路且全部代碼可自托管、可審計?!久赓M(fèi)下載鏈接】lagoOpen Source Metering and Usage Based Billing API ?? Consumption tracking, Subscription management, Pricing iterations, Payment orchestration Revenue analytics項(xiàng)目地址: https://gitcode.com/GitHub_Trending/la/lago創(chuàng)作聲明:本文部分內(nèi)容由AI輔助生成(AIGC),僅供參考