MaaS Cloud API

Multi-tenant LLM API Management Platform

English · 简体中文

---

MaaS Cloud is a multi-tenant LLM API management platform for resellers and enterprises. Built on Higress AI Gateway + Go microservices, supporting 40+ model providers, independent reseller branding, and per-token billing.

🚧 Early stage — Core architecture is complete. Some feature modules are still being implemented.

✨ Features

Feature	Description
🔗 Unified API	One endpoint for 100+ models. OpenAI SDK compatible. Zero migration cost.
🏢 Multi-Tenant	Each reseller gets their own domain, logo, theme, and pricing. Full data isolation.
🔐 SSO	Platform-wide auth center with Google OAuth. Zero config for resellers.
👥 RBAC	6 roles: owner / operator / sales / finance / tech / user
📊 Dynamic Menus	Menus and permissions loaded from DB, rendered by role + tenant type
🌐 i18n	Chinese & English via next-intl, per-module translation files
⚡ Smart Routing	Higress-native load balancing + automatic failover
💰 Token Billing	Per-request metering with custom markup and revenue sharing
💳 Recharge	Stripe self-service (instant) + Sales-initiated (finance approval)
📈 Observability	OpenTelemetry + Jaeger + Prometheus + Grafana
🔌 Adapter	Support for non-OpenAI APIs like Kling, Midjourney via Adapter service

🏗️ Architecture

                     User Request (reseller domain)
                              │
                              ▼
  ┌─────────────────────────────────────────────────┐
  │                   Higress Gateway                │
  │  Domain routing · Auto TLS · Rate limit · AI Proxy │
  └──────────┬──────────────┬──────────────┬────────┘
             │              │              │
      ┌──────▼──────┐ ┌────▼────┐    AI Proxy
      │  Auth Svc   │ │Core Svc │    → Upstream LLMs
      │  SSO/OAuth  │ │ CRUD    │
      └─────────────┘ └────┬────┘
                           │
              ┌────────────┼────────────┐
              │            │            │
       ┌──────▼─────┐ ┌───▼────┐ ┌─────▼─────┐
       │  Billing   │ │Syncer  │ │ Adapter   │
       └────────────┘ └────────┘ └───────────┘

🚀 Quick Start

git clone https://github.com/LayFz/maas-cloud-api.git
cd maas-cloud-api

# Start MySQL + Redis
docker compose -f docker-compose.dev.yaml up -d

# Backend
go mod tidy
make dev-auth    # :8080
make dev-core    # :8081

# Frontend
cd web && npm install && npm run dev
# http://localhost:3000 — admin / admin123

📖 Documentation

Doc	Description
Ops Guide	K3s deployment, infra, monitoring, scaling
Backend Guide	Microservices, data isolation, RBAC
Frontend Guide	Module conventions, permissions, i18n
Local Dev	Step-by-step local setup

📄 License

AGPL-3.0 © 2026 LayFz