Credits und Guthaben
Wie Veille-Credits funktionieren und wie Sie Ihr Guthaben aufladen.
Jeder abrechenbare Aufruf zieht Credits von Ihrem Workspace ab. Das Dashboard-Panel Nutzung unter Einstellungen → Abonnement zeigt drei Guthaben. Der API-Usage-Endpunkt meldet eine kombinierte Restlaufzeit, damit Sie aus dem Code heraus alarmieren können, ohne jeden Bucket zu parsen.
Nutzung
Aktueller Zeitraum38,400
10,000
3,780
Abonnement
Pro · Verlängerung am 1.
Die drei Guthaben
| Guthaben | Was es ist | Zurücksetzung |
|---|---|---|
| Abo-Kontingent | API-Aufrufe, die in Ihrem Tarif enthalten sind | Ja — zu Beginn jeder Abrechnungsperiode (von Stripe, falls verfügbar, sonst der Kalendermonat). Unverbrauchtes Kontingent wird nicht übertragen. |
| Einmaliges API-Paket | Zusätzliches API-Kontingent aus einem einmaligen Kauf | Nie — wird verbraucht, bis es aufgebraucht ist, über Abrechnungsperioden hinweg |
| Pay-as-you-go-Guthaben | Ein separates Journal, das erst genutzt wird, wenn Abo-Kontingent und API-Pakete leer sind | Nie — Gutschriften bleiben bis zur Nutzung |
Im Dashboard erscheinen diese drei Balken unter Einstellungen → Abonnement → Nutzung (und im Panel API-Nutzung der Seitenleiste). Am Usage-Endpunkt (/v1/usage) ist das Objekt subscription das kombinierte API-Kontingent (Abo + verbleibende Pakete). Pay-as-you-go liegt unter credits. Das Top-Level-remaining ist die Summe beider.
Verbrauchsreihenfolge
Zuerst das Abo-Kontingent
Abrechenbare Aufrufe füllen die Tarif-Zuteilung für die aktuelle Periode.
Dann einmalige API-Pakete
Ist die Periodenzuteilung aufgebraucht, wird als Nächstes das verbleibende Paketkontingent verbraucht. Pakete werden in Kaufreihenfolge verbucht.
Dann Pay-as-you-go-Guthaben
Nur wenn das kombinierte API-Kontingent die Endpunktkosten nicht decken kann, belasten wir das Pay-as-you-go-Journal.
Andernfalls wird der Aufruf abgelehnt
Die API gibt 402 mit Payment required zurück, und die Anfrage wird nicht ausgeführt.
Was abgerechnet wird
| Ergebnis | Credits |
|---|---|
200 oder 201 (erfolgreiche / akzeptierte abrechenbare Antwort) | Ja — die Credit-Kosten des Endpunkts |
404 | Meist ja — außer der Endpunkt markiert 404 als kostenlos (angezeigt in der Bibliothek und auf der Endpunkt-Seite) |
401, 402, 400, 5xx und die meisten anderen Fehler | Nein — und jede Pay-as-you-go-Reservierung wird freigegeben |
| Pro-Zeile-Endpunkte mit 0 Ergebnissen | Kostenlos |
| Pro-Zeile-Endpunkte mit N Ergebnissen | N × die Kosten pro Zeile — alles oder nichts (unzureichendes Guthaben → 402, bevor Zeilen zurückgegeben werden) |
/v1/usage und Job-Status-URLs | Immer kostenlos — keine Kontingentprüfung |
Jeder Endpunkt deklariert seine Kosten in der Bibliothek (und in der API-Referenz): N Credits pro Aufruf oder pro Zeile. Das Guthaben wird geprüft, bevor die Arbeit beginnt, sodass ein Job nie ohne die Credits zur Bezahlung angenommen wird. Das Abfragen eines Job-Status kostet nie Credits.
Mehr Kapazität kaufen
Abonnement-Einstellungen öffnen
Gehen Sie zu Einstellungen → Abonnement und klicken Sie auf Alle Pläne anzeigen (oder öffnen Sie https://app.veille.io/pricing).
Ein Einmalpaket wählen
Je nach Produkt erhöht ein Paket das API-Kontingent (einmaliges API-Paket) oder das Pay-as-you-go-Journal. Es ändert für sich allein nie Ihre Tarifstufe. Größere Pakete kosten in der Regel weniger pro Credit.
Zahlung bestätigen
Die Kapazität ist verfügbar, sobald die Zahlung erfolgreich ist, und eine Rechnung wird an die Rechnungsadresse gemailt.
Gekaufte Pakete erscheinen auch unter Einstellungen → Abonnement → Einmalpakete. Zum automatischen Auffüllen, wenn das kombinierte Guthaben sinkt, siehe Automatisches Aufladen.
Wo Sie den Verlauf lesen
| Bildschirm | Was er zeigt |
|---|---|
| Einstellungen → Abonnement → Nutzung | Live verbleibend / verbraucht für die drei Guthaben der aktuellen Periode |
| API-Protokolle | Jede Anfrage mit Status, Dauer und berechneten Credits — einschließlich Abo- und Paketverbrauch |
| Einstellungen → Guthaben | Nur das Pay-as-you-go-Journal: Gutschriften (Belohnungen, manche Pakettypen, automatisches Aufladen) und Ausgaben nach leerem API-Kontingent. Filtern nach Mitglied oder Typ. |
Usage-Endpunkt (/v1/usage) | Maschinenlesbarer Snapshot: remaining, subscription, credits, renewal_date — kostenlos aufrufbar |
Wenn Einstellungen → Guthaben leer wirkt, während Analytics Traffic zeigt, ist das erwartbar: Abo- und Paketverbrauch erscheinen nie auf dieser Seite. Nutzen Sie stattdessen API-Protokolle oder die Nutzungsbalken.
Wenn Sie 402 sehen
| Meldung | Bedeutung | Was tun |
|---|---|---|
Payment required | Kein Abo-Kontingent, keine Pakete und kein Pay-as-you-go mehr für die Kosten dieses Aufrufs | Paket kaufen, Tarif upgraden oder automatisches Aufladen aktivieren |
You have open invoices: … | Eine unbezahlte Rechnung blockiert das Konto | Begleichen unter Einstellungen → Rechnungen — Guthaben allein reicht nicht |
Insufficient credits: X required, Y available | Ein Pro-Zeile-Endpunkt würde mehr Zeilen zurückgeben, als Sie bezahlen können | Aufladen oder die Anfrage so eingrenzen, dass weniger Zeilen zurückkommen |
FAQ
- Wird ungenutztes Tarifkontingent übertragen? Nein. Der Abo-Bucket wird jede Abrechnungsperiode zurückgesetzt.
- Verfallen Einmalpakete zum Monatsende? Nein. Sie bleiben bis zum Verbrauch.
- Teilen alle Schlüssel dieselben Guthaben? Ja — das Kontingent gilt workspace-weit.
- Kostet das Prüfen der Nutzung Credits? Nein.
/v1/usageund Job-Status-Pfade sind kostenlos. - Warum ist die Dashboard-Nutzung aufgeteilt,
/usage.subscriptionaber kombiniert? Damit eine einzelneremaining-Zahl für Alarme reicht; öffnen Sie das Dashboard, wenn Sie die Dreiteilung brauchen.