MeterFlow

Pläne, Limits und Abrechnung — klar beantwortet

Alles, was die Preistabelle nicht ausbuchstabiert: was ein Event ist, was am Limit passiert, wann du eine zweite Organisation brauchst und wie die Zahlung läuft. Wie das Produkt selbst funktioniert, erklärt der Dashboard-Leitfaden.

Pläne & Abrechnung

Was zählt genau als Nutzungsevent?

Ein Nutzungsevent ist ein Datensatz, den deine Anwendung an MeterFlow sendet — „Kunde user-842 hat 1 Bild generiert“, „42 Sekunden Video gerendert“. Jeder Datensatz zählt einmal, ob einzeln gesendet oder viele in einem Batch-Aufruf.

Events werden pro Organisation gezählt — über alle ihre Projekte und alle deine Kunden — je Kalendermonat (UTC). Lesezugriffe zählen nie: Saldo prüfen, Pläne auflisten oder eine Nutzungsübersicht abrufen ist kostenlos. Auch das Gutschreiben oder Abziehen von Credits ist kein Nutzungsevent.

Wie aus einem Event eine Zahl auf der Nutzungsseite eines Kunden wird, erklärt der Dashboard-Leitfaden.

Kann ich dieselbe Nutzung mit weniger Events erfassen?

Meist ja — und es ist der wirksamste Hebel, den du hast. Ein Nutzungsevent trägt eine Menge im Feld value, und ein Meter mit der Aggregation Sum addiert diese Werte. Ein einzelnes Event mit value 1.300 ist also ein Event auf dein Monatskontingent und 1.300 Einheiten auf dem Meter.

Was einen Tarif aufbraucht, ist ein Event pro API-Aufruf: 1.000 Nutzer mit je 100 Aufrufen pro Tag sind rund 3 Millionen Events im Monat. Aggregiere in deiner eigenen Anwendung über das Fenster, dessen Verlust du bei einem Absturz verschmerzen kannst — eine Anfrage, ein Job, eine Minute — und erfasse dann ein einziges Event mit der Summe.

Wichtig: Batching ist nicht dasselbe. 100 Events in einem Batch-Aufruf sparen HTTP-Anfragen, aber jedes bleibt ein eigener Datensatz und zählt weiterhin. Nur das Zusammenfassen zu einem Event mit größerem value senkt die Zahl.

Zwei Einschränkungen: Es funktioniert bei Sum-Metern, denn Count-Meter ignorieren den Wert und zählen Vorkommnisse; und am Preis ändert sich nichts, da ein Metered-Tariflimit ohnehin pro Einheit abrechnet.

Was passiert, wenn meine Organisation ihr monatliches Event-Limit erreicht?

Du erfährst es lange bevor es greift: Wir schicken dem Rechnungskontakt der Organisation bei 80 % und erneut bei 100 % der enthaltenen Events eine E-Mail, und die Abrechnungsseite zeigt den Verbrauch des Monats im Verhältnis zu deinem Tarif.

Das Überschreiten von 100 % stoppt die Erfassung nicht sofort — ein kleiner Puffer über der enthaltenen Menge hält deinen Produktiv-Traffic am Laufen, während du entscheidest. Danach werden neue Nutzungsevents mit einem klaren Fehler „Plan limit reached“ abgelehnt (HTTP 403), bis du upgradest oder der neue Monat beginnt. Nichts geht stillschweigend verloren, und nichts wird berechnet — MeterFlow stellt nie Mehrverbrauch in Rechnung.

Alles andere läuft weiter: bereits erfasste Events, Credit-Salden, Abonnements, das Dashboard und jeder Lese-Endpunkt. Der Zähler wird zu Beginn jedes Kalendermonats (UTC) zurückgesetzt; ein Upgrade hebt das Limit sofort an, ein Event-Paket hebt es für den laufenden Monat.

Deine Anwendung erhält die Ablehnung als normalen API-Fehler: Behandle ihn wie jeden anderen 4xx — protokollieren und nicht blind wiederholen.

Eine wiederholte Anfrage wird nie für Events abgelehnt, die sie schon erfasst hat: Ein mit denselben Idempotenz-Schlüsseln erneut gesendeter Batch antwortet mit den Events, die er angelegt hat, auch am Limit. Und sobald deine Organisation ein Limit erreicht, nennt ihre Billing-Seite es bei deinem Plan und zeigt, falls es einen gibt, den Plan, der zu deiner Nutzung passt.

Zahle ich pro Event? Gibt es Mehrverbrauchskosten?

Nein. Jeder Plan hat einen festen Monatspreis mit einer festen Anzahl enthaltener Events. Die Zeile „Effektiver Preis / 1.000 Events“ auf der Preisseite ist einfach dieser Preis geteilt durch die enthaltenen Events — ein Vergleichswert, kein Tarif, den wir berechnen.

Brauchst du mehr Events, als dein Plan enthält, gibt es zwei Wege — und keiner ist eine Verbrauchsrechnung: eine Stufe höher gehen oder ein Event-Paket dazunehmen — 100.000 zusätzliche Events für 15 $, über deine Billing-Seite, bis zu zehn auf einmal. Ein Paket gilt für den Monat, in dem du es kaufst (in den letzten fünf Tagen eines Monats gekauft, deckt es auch den nächsten ab) und wird nicht übertragen. Es liegt bewusst über der effektiven Rate jedes bezahlten Tarifs: bei stetigem Wachstum ist das Upgrade günstiger, das Paket ist für die ungeplante Spitze.

Kann ich jährlich zahlen?

Derzeit nicht — jeder Plan wird monatlich abgerechnet. Wenn jährliche Abrechnung für deinen Einkauf wichtig ist, schreib uns an support@meter-flow.com.

Wie läuft die Zahlung — Währung, Umsatzsteuer, Rechnungen?

Checkout und Abrechnung übernimmt Paddle, unser Merchant of Record. Die Preise sind in USD; Paddle zeigt beim Checkout deine lokale Währung und die anfallende Umsatzsteuer, zieht die Zahlung ein (Karten, PayPal, Apple Pay, Google Pay) und stellt die Rechnung aus. Unternehmen können beim Checkout ihre USt-IdNr. angeben.

Kann ich upgraden, downgraden oder kündigen?

Ja, jederzeit. Upgrades heben deine Limits sofort an. Wenn du kündigst, bleibt dein Plan bis zum Ende des bezahlten Zeitraums aktiv. Deine erste Zahlung ist durch eine 14-tägige Geld-zurück-Garantie gedeckt — siehe Erstattungsrichtlinie.

Ein Downgrade löscht nie etwas: Liegt deine Organisation über den Grenzen des kleineren Plans, funktioniert Bestehendes weiter — du kannst nur nichts hinzufügen, bis du wieder darunter bist.

Organisationen, Projekte & Team

Organisation oder Projekt — was brauche ich?

Fast immer ein Projekt. Ein Projekt ist ein Produkt oder eine App: mit eigenen API-Schlüsseln, Metern, Plänen, Kundensalden und Nutzung; Projekte sehen nie die Daten der anderen. Alle Projekte einer Organisation teilen sich ein Event-Kontingent und eine Rechnung — jeder Bezahlplan enthält 20 davon.

Eine Organisation ist die Abrechnungsgrenze: eigener Plan, eigenes Event-Kontingent, eigene Rechnung, eigenes Team. Lege eine zweite nur an, wenn du wirklich getrennte Abrechnung oder ein getrenntes Team brauchst — etwa zwei Firmen. Jede Organisation wird über ihren eigenen Plan abgerechnet; zusätzliche starten kostenlos auf Drip.

Ich habe mehrere Produkte oder bin eine Agentur mit mehreren Kunden — eine Organisation oder viele?

Eine Organisation, mit einem Projekt pro Produkt oder Kunde. Du zahlst einmal, und das Event-Kontingent wird von allen geteilt. Mehrere Organisationen bedeuten mehrere Rechnungen.

Gib einem Kunden nur dann eine eigene Organisation, wenn er eine eigene Rechnung erhalten und ein eigenes Team verwalten muss — diese Organisation läuft dann auf ihrem eigenen Plan.

Zählen meine eigenen Kunden als Team-Sitze?

Nein. Team-Sitze sind deine Kolleginnen und Kollegen im Dashboard — du plus die Personen, die du einlädst. Deine Endnutzer melden sich nie bei MeterFlow an: Sie existieren nur als Kunden-IDs in deinem Projekt, sind in jedem Plan unbegrenzt und kosten nichts pro Kunde.

Ich wurde in eine fremde Organisation eingeladen — beeinflusst das meine Limits?

Nein. Das Organisationslimit zählt nur Organisationen, die du besitzt. In einer Organisation, in die du eingeladen wurdest, gilt der Plan ihres Eigentümers — für alle Mitglieder.

Limits & Umgebungen

Sind Projekte, Meter, API-Schlüssel und Webhooks in Bezahlplänen wirklich begrenzt?

Ja, und die Zahlen sind veröffentlicht: 20 Projekte, 75 Meter pro Projekt, 10 API-Schlüssel pro Projekt und Umgebung, 30 Webhook-Endpunkte pro Projekt — in jedem Bezahlplan gleich. Es sind Plattform-Obergrenzen, so bemessen, dass eine echte Integration sie nie erreicht — keine Upsell-Hebel: Ein Upgrade verschiebt sie nicht. Braucht deine Integration wirklich mehr, schreib an support@meter-flow.com.

Der kostenlose Drip-Plan hat kleinere Grenzen zum Ausprobieren (2 Projekte, 5 Meter, 4 API-Schlüssel pro Umgebung, 3 Webhooks); dort hebt ein Upgrade sie tatsächlich an. Das API-Schlüssel-Limit bleibt auch in Bezahlplänen absichtlich moderat: Jeder aktive Schlüssel ist ein Zugangsdatum mit eigenem Rate-Limit, also eine Sicherheitsgrenze — widerrufe Schlüssel, die du nicht mehr nutzt.

Was passiert, wenn ich eine dieser Grenzen erreiche?

Die Aktion zum Anlegen wird mit einer Meldung abgelehnt, die das Limit nennt — Bestehendes bleibt unberührt. Auf Drip lädt die Meldung zum Upgrade ein, weil die Bezahlgrenzen höher sind; in einem Bezahlplan verweist sie auf den Support, weil ein Upgrade die Grenze nicht ändern würde und wir nichts anderes versprechen wollen.

Brauchen Test- und Live-Umgebung getrennte Pläne?

Nein — jeder Plan enthält beide. Test-Schlüssel (mf_test_…) und Live-Schlüssel (mf_live_…) schreiben in vollständig isolierte Daten: Salden, Abonnements und Nutzung vermischen sich nie, während Meter und Pläne gemeinsame Konfiguration sind, die du einmal definierst. Das API-Schlüssel-Limit gilt pro Umgebung: Ein Projekt bekommt die volle Anzahl Live-Schlüssel und die volle Anzahl Test-Schlüssel.

Zählen Test-Events zu meinen monatlichen Events?

Nein. Events, die mit einem Test-Schlüssel (mf_test_…) gesendet werden, haben ein eigenes Monatskontingent, ein Zehntel des Plan-Kontingents: 5.000 auf Drip, 20.000 auf Flow, 70.000 auf Stream und 400.000 auf Torrent. Sie zählen nie zu den Live-Events des Plans, und ein Event-Paket erhöht nur das Live-Kontingent. Jenseits des Test-Kontingents (plus derselben kleinen Reserve, die Live-Traffic bekommt) werden neue Test-Events mit einem Fehler abgelehnt, der es benennt.

Test-Schlüssel sind außerdem auf 60 Anfragen pro Minute begrenzt (Live-Schlüssel: 300), und Testdaten laufen ab: Test-Nutzungsevents werden nach 30 Tagen gelöscht, und ein Test-Abonnement ohne Nutzung seit 90 Tagen wird samt seinem Test-Saldo und Test-Journal gelöscht. Keine der beiden Regeln berührt Live-Daten.

Die Billing-Seite und der Usage-Dialog deiner Organisation zeigen die Test-Events des Monats gegen ihr Kontingent, neben den Live-Events.

Was bedeutet Analytics-Aufbewahrung — verliere ich Daten?

Die Aufbewahrung sagt, wie lange deine Live-Nutzungsevents gespeichert bleiben — von 45 Tagen auf Drip bis 12 Monaten auf Torrent. Ältere Events werden gelöscht, Übersichten und Analysen reichen also so weit zurück; exportiere sie vorher, wenn du sie länger behalten willst. Credit-Salden und das Live-Transaktionsjournal werden dabei nicht gelöscht, egal welcher Plan: Jede Gutschrift, jeder Abzug und jede Belastung bleibt erfasst. Testdaten haben eine eigene, kürzere Frist — siehe die Frage davor.

Hilfe

Was bedeuten die Support-Stufen?

Community (Drip): die Dokumentation auf dieser Website, das Community-Forum (GitHub Discussions, für beide SDKs) und die Issue-Tracker der öffentlichen SDK-Repositories (Node.js, Python) — jederzeit einsehbar, beantwortet wenn wir können, ohne garantierte Antwort. E-Mail (Flow): Schreib an support@meter-flow.com (oder nutze das Hilfeformular) und ein Mensch antwortet. Priorität (Stream und Torrent): Deine Nachrichten werden vor der Warteschlange bearbeitet.

Kein Plan enthält bisher ein vertragliches SLA — wir drucken keins, bevor wir es einhalten können.

Für welche Sprachen gibt es ein SDK?

Node.js (npm install meterflow, Doku) und Python (pip install meterflow, Doku). Beide sind vollständig typisiert — das Node.js-Paket hat keine Laufzeit-Abhängigkeiten, das Python-Paket hängt nur von httpx ab — und decken dieselben Operationen ab: Credits, Nutzungsevents, Abonnements, Pläne und Entitlement-Prüfungen, dazu eine schreibgeschützte Sicht auf deine Webhook-Endpunkte und deren Zustellbelege. Jede andere Sprache ruft die REST-API direkt auf — die SDKs sind dünne Hüllen darüber, kein eigener Funktionsumfang.

Können meine Kunden ihr Guthaben sehen, ohne dass ich eine Seite baue?

Ja. MeterFlow hostet eine Seite, die einem deiner Kunden sein Credit-Guthaben, die letzten Bewegungen und seinen Plan zeigt, mit dem, was von jedem abgerechneten Kontingent übrig ist — unter deinem Namen, mit deinem Logo und deinen Farben. Dein Server erzeugt mit portal.createSession() (in Python create_session()) einen Link und schickt den Kunden dorthin; es gibt keine Seite zu bauen oder zu hosten.

Ein Link gilt eine Stunde, sofern du nichts anderes wählst, höchstens einen Tag, und ist nur lesend. Ein Buy more-Button kann deine eigene Checkout-Seite öffnen: MeterFlow nimmt nie die Zahlung entgegen — meldet dein Checkout sie, schreibt dein Server die Credits gut. Wie alles zusammenpasst, erklärt der Dashboard-Leitfaden.

Was passiert mit meinen Daten, wenn es MeterFlow nicht mehr gibt?

Du kannst sie jederzeit mitnehmen. Ein Owner oder Admin der Organisation kann Nutzungsevents, Credit-Journal, Abonnements und Credit-Reservierungen jedes Projekts als CSV oder JSON Lines herunterladen, eine Umgebung (Live oder Test) pro Datei — über Daten exportieren in der Projekttabelle des Dashboards oder über die API (GET /api/v1/projects/{project_id}/export/{dataset}).

Jede Zeile wird genau so geschrieben, wie die API diesen Datensatz zurückgibt, und eine große Tabelle lädt in einer einzigen Anfrage herunter.

Wie schließe ich mein Konto oder lösche meine Organisation?

Beides geht im Dashboard. Um eine Organisation zu löschen, wählt ihr Owner im Dashboard Löschen bei ihr: Ihre Projekte werden sofort abgeschaltet, und die Organisation wird mit allem, was darin ist, gelöscht, sobald 30 Tage vergangen sind. Ein bezahlter Plan wird vorher auf ihrer Billing-Seite gekündigt.

Um dein Konto zu schließen, öffne dein Profil (dein Bild, oben rechts), wähle Konto löschen und gib dein Passwort ein. Lösche zuerst die Organisationen, deren Owner du bist; dein Konto wird dann gelöscht, sobald 30 Tage vergangen sind. Bis dahin kannst du dich anmelden und beides abbrechen. Du kannst dich nicht anmelden? Schreib an support@meter-flow.com.

Wo lerne ich, wie Meter, Pläne, Credits und Nutzungsevents wirklich funktionieren?

Der Dashboard-Leitfaden erklärt jeden Dialog Feld für Feld mit Beispielen, und die Dashboard-Tour zeigt die Bildschirme. Diese Seite behandelt nur Pläne und Abrechnung.

↑