Zum Seiteninhalt springen
Docs
Make Agent Fast Dokumentation

Credits und Nutzung

Guthaben auslesen, Kontingente unterscheiden, den Verbrauch prognostizieren und auf unerwartete Nutzung reagieren.

Auf einen Blick

Guthaben auslesen, Kontingente unterscheiden, den Verbrauch prognostizieren und auf unerwartete Nutzung reagieren.

API-AnfragepfadSchlüssel mit Bereich → versionierte Ressource → signierte Antwort
App / SDKBearer-Schlüsselmaf_live_…/api/v1/…RessourceJSON
CreditsSprachminutenAufladungen
Video-Tutorial · Folge 8Analysen, Team & Abrechnung2:37 – 3:34 · Englischer TonGanze Folge und Kapitel →

Die Nutzungsseite lesen#

Der Nutzungsbereich im Dashboard vereint Abrechnungsinformationen mit den Ressourcen, die einen Vorgang stoppen können: aktueller Tarif, Credit-Guthaben, Website-Kontingent, Live-Sprachminuten, Aufladeoptionen und Abrechnungsaktionen. Prüfen Sie ihn vor einem Launch und nach dem Hinzufügen eines Embeds, Connectors oder API-Clients mit hohem Volumen.

Interpretieren Sie eine einzelne Zahl nicht als allgemeine Quote. Jedes Kontingent schützt eine andere Ressource.

Guthaben und Limits unterscheiden#

RessourceZurücksetzung oder VerfallWas beim Erreichen des Limits passiert
Monatliche KI-CreditsWerden um einen weiteren Zyklus übertragen, verfallen dannAbgerechnete KI-, Wissens- und Sprachaktionen können abgelehnt werden
Gekaufte CreditsVerfallen nicht, solange ein Abonnement aktiv istFinanzieren weiterhin abgerechnete Vorgänge, solange der Zugang aktiv bleibt
Anzahl der WebsitesTarifkontingentDas Anlegen einer weiteren Website wird blockiert
Live-SprachminutenMonatliches TarifkontingentNeue oder laufende Echtzeitsitzungen werden eingeschränkt bzw. beendet
API-AnfragenPro API-Schlüssel und MinuteDie Anfrage liefert 429 mit Retry-Headern zurück

Credits erhöhen weder den API-Durchsatz noch die Anzahl der Websites oder Live-Minuten. Ein Kontingent garantiert nicht, dass der für den Vorgang erforderliche Credit- bzw. Provider-Pfad zur Verfügung steht.

Was Credits verbraucht#

Abgerechnete Vorgänge können die Generierung von Websites und Agents, normale Agent-Antworten, Wissens-Embeddings, Medientranskription, Text-to-Speech und Connector-Sprache umfassen. Die Kosten variieren je nach Provider, Modell, Länge von Prompt und Kontext, Länge der Ausgabe, Audiodauer und Vorgangstyp. Eine „Nachricht“ hat daher keinen festen, allgemeingültigen Credit-Preis.

Vorschau- und Testaktionen des Owners können echte Ressourcen verbrauchen, wenn sie Live-Provider aufrufen. Verwenden Sie kurze, repräsentative Abnahmetests und vermeiden Sie es, dieselbe große Quelle beim Debuggen eines anderen Problems wiederholt zu indexieren.

Nutzungsverlauf lesen#

Der Nutzungsverlauf zeigt die tatsächlich verbrauchten finalen Credits jedes abgeschlossenen Vorgangs. Vorübergehende Autorisierungsreservierungen, Abrechnungen von Reservierungen und Erstattungen bleiben interne Buchungsdetails und erscheinen nicht als separate, für Kunden sichtbare Zeilen. Sehr kleine Embedding-Vorgänge werden als <0.001 angezeigt statt auf null gerundet.

Weitere Guthabenänderungen ist eine separate Tabelle für Gutschriften von Tarif-Credits, Aufladungen, Verfall und manuelle Anpassungen. Sie dupliziert keine normale KI-Nutzung. Solange ein Vorgang noch läuft, kann das verfügbare Guthaben vorübergehend eine Reservierung widerspiegeln, bevor die finale Nutzungszeile erscheint oder ein fehlgeschlagener Vorgang freigegeben wird. Aktualisieren Sie die Seite nach Abschluss, wenn Sie eine soeben beendete Aktion abgleichen.

Monatliche und gekaufte Credits#

Das monatliche Kontingent richtet sich nach dem aktiven Tarif. Nicht verbrauchte monatliche Credits werden um einen weiteren Zyklus übertragen und verfallen dann. Einmalige Pakete bieten 1.000 Credits für 8 $, 5.000 für 35 $ oder 15.000 für 90 $; gekaufte Credits verfallen nicht, solange ein Abonnement aktiv ist.

Der Kauf eines Pakets stellt ein gekündigtes oder abgelaufenes Plattform-Abonnement nicht wieder her. Klären Sie zuerst Zugang und Abrechnung, wenn das Dashboard ein Kontingentproblem meldet und nicht nur ein niedriges Guthaben.

Automatische Aufladung#

Die automatische Aufladung steht erst zur Verfügung, wenn das automatische Belasten von Karten für Make Agent Fast aktiviert ist; bis dahin weist die Seite darauf hin, dass sie nicht verfügbar ist. Wo sie angeboten wird, kauft sie für Sie ein Credit-Paket, sobald das Guthaben einen von Ihnen gewählten Schwellenwert erreicht. Aktivieren Sie sie unter Nutzung & Credits → Automatische Aufladung: Wählen Sie den Schwellenwert (zwischen 50 und 5.000 Credits) und das zu kaufende Paket. Belastet wird die Karte, die beim Zahlungsanbieter bereits hinterlegt ist; fügen Sie diese Karte über den Link zum Kundenportal neben dem Formular hinzu oder ändern Sie sie dort.

Die Schutzmechanismen sind bewusst gewählt. Es läuft immer nur ein Kauf gleichzeitig, und während er abgewickelt wird, zeigt die Seite an, dass ein Kauf in Bearbeitung ist. Pro Tag finden höchstens drei automatische Käufe statt. Die Credits erscheinen, wenn die Zahlung abgeschlossen ist, nicht bereits beim Start der Belastung. Wird die Karte abgelehnt, werden keine Credits gutgeschrieben, die Seite zeigt den letzten Fehler an, und eine E-Mail pro Tag erklärt, was zu beheben ist; die Belastung wird erst wieder versucht, wenn die Zahlungsmethode funktioniert.

Die automatische Aufladung ist nur verfügbar, wenn Off-Session-Abbuchungen aktiviert sind und eine Karte hinterlegt ist. Ist sie nicht verfügbar, teilt die Seite dies mit, anstatt einen Schalter anzuzeigen, der nichts bewirken würde.

Add-ons#

Add-ons können erst gekauft werden, wenn sie zum Verkauf angeboten werden: Ein angebotenes Add-on erscheint unter Nutzung & Credits → Add-ons, und die Karte wird ausgeblendet, wenn keines angeboten wird. Ein Add-on, für das Sie bereits zahlen, bleibt immer aufgelistet, damit Sie es kündigen können. Angebotene Add-ons erweitern die Kapazität zusätzlich zum aktuellen Tarif, werden monatlich abgerechnet und sind jederzeit kündbar.

Add-onPreis, wenn angebotenHinweise
Zusätzlicher Agent10 $ pro Agent und MonatMehrfach kaufbar; jedes Add-on fügt genau einen Agent-Platz hinzu. In Scale enthalten.
Badge entfernen9 $ pro MonatBlendet „Made with Make Agent Fast“ im Widget aus. In Operate und Scale enthalten.

Ein Add-on ist ein vom Tarif getrenntes Abonnement: Die Kündigung des Add-ons berührt den Tarif nicht, und die Kündigung des Tarifs behält das Add-on nicht stillschweigend bei. Ein gekündigtes Add-on läuft bis zum Ende des bereits bezahlten Zeitraums. Nur der Abrechnungs-Owner kann ein Add-on kaufen oder kündigen.

Abrechnung von Live-Sprache#

Operate enthält 30 Live-Minuten pro Monat, Scale 90. Zusätzlich hat jeder Anruf ein vom Owner konfiguriertes automatisches Zeitlimit von 30 Sekunden bis 20 Minuten. Wenn ein Live-Anruf-Token ausgestellt wird, wird dem Wallet vorab die vom Server autorisierte maximale Dauer belastet, begrenzt durch das verbleibende Monatskontingent. Dieselbe Dauer wird auf das Live-Minuten-Kontingent angerechnet, sodass parallele Anrufe es nicht überschreiten können.

Live-Medien fließen direkt zwischen Browser und Echtzeit-Provider, daher kann der Server eine kürzere, vom Client gemeldete Dauer nicht unabhängig überprüfen. Ungenutzte Zeit wird deshalb nach Ausgabe eines Tokens nicht anteilig erstattet; eine abgebrochene oder nicht gemeldete Sitzung wird mit ihrem autorisierten Limit abgerechnet. Ein serverseitiger Fehler vor der Token-Ausgabe gibt die Belastung wieder frei. Beenden Sie Anrufe ordnungsgemäß, um die Sitzung zügig zu schließen, prognostizieren Sie Credits aber anhand des konfigurierten Anruflimits und nicht anhand der erwarteten Gesprächsdauer des Anrufers.

Sprachnachrichten funktionieren anders: Sie verbrauchen abgerechnete Transkriptions-, Modell- und Sprachleistungen statt des Live-Minuten-Kontingents. Ermitteln Sie den richtigen Bucket, wenn ein Modus funktioniert und der andere fehlschlägt.

Nutzung prognostizieren#

  1. Wählen Sie repräsentative kurze, normale und lange Fragen von Besuchern.
  2. Testen Sie Text, wissensintensive Antworten, Sprachnachrichten und Live-Anrufe getrennt.
  3. Erfassen Sie die Änderungen bei Credits und Minuten für das Abnahme-Set.
  4. Multiplizieren Sie mit dem erwarteten täglichen Traffic und dem Channel-Mix.
  5. Planen Sie Reserven für Wiederholungsversuche, Crawls, Provider-Ausfälle, interne QA, Kampagnen und Traffic-Spitzen ein.
  6. Prüfen Sie erneut, nachdem Sie Modell, Provider, Größe der Sources, Antwortlänge oder Sprachverhalten geändert haben.

Nutzen Sie Analysen und Konversationen, um die Ursache eines Anstiegs zu finden. Ein Traffic-Anstieg, ein API-Client in einer Endlosschleife, ein kompromittierter Schlüssel, ein kopiertes Embed auf einer unbeabsichtigten Origin, ein Connector-Retry oder ein wiederholter Indexierungsjob erfordern jeweils eine andere Lösung.

Unerwartete Nutzung verhindern#

  • Beschränken Sie Embeds auf die exakt vorgesehenen Origins.
  • Vergeben Sie API-Schlüsseln die kleinstmöglichen Scopes und trennen Sie Schlüssel nach Dienst und Umgebung.
  • Machen Sie Mutationen idempotent und beachten Sie die Retry-Header bei 429.
  • Prüfen Sie Webhook-Signaturen und deduplizieren Sie Event-IDs.
  • Rotieren Sie kompromittierte API-, Provider- und Connector-Zugangsdaten sofort.
  • Halten Sie öffentliche Agents durch eine klare Persona und eindeutige Antwortanweisungen im Rahmen.
  • Entfernen Sie veraltete Automatisierungen, Preview-Deployments, Connectors und ungenutzte Schlüssel.
  • Benachrichtigen Sie die operativ Verantwortlichen, bevor Guthaben oder Live-Minuten gegen null gehen.

Einen Anstieg untersuchen#

Halten Sie den betroffenen Workspace bzw. die Website, den Zeitraum, den Channel, das Deployment und die letzten Änderungen fest. Vergleichen Sie die Nutzung mit Analysen, Zeitstempeln der Konversationen, API-Request-IDs, Webhook-Zustellprotokollen und dem Status des letzten Events bzw. Fehlers des Connectors. Senden Sie keine Schlüssel im Klartext und keine Inhalte von Besuchern an den Support, es sei denn, ein freigegebener sicherer Prozess verlangt dies ausdrücklich.

Beseitigen Sie zuerst die Ursache: Deaktivieren Sie einen Connector, widerrufen Sie einen Schlüssel, entfernen Sie eine unbeabsichtigte Origin oder stoppen Sie eine Retry-Schleife im Client. Sichern Sie anschließend unbedenkliche Nachweise, rotieren Sie bei Bedarf Zugangsdaten und aktivieren Sie die Pfade nacheinander wieder.

Fehlerbehebung#

SymptomPrüfen
Keine Credits mehr trotz ungenutzter Live-MinutenEs handelt sich um getrennte Ressourcen; fügen Sie Credits für normale KI-Vorgänge hinzu bzw. erneuern Sie sie
Sprachnachrichten funktionieren, Live-Anruf nichtLive-Kontingent des Tarifs, verbleibende Minuten, Verfügbarkeit des Echtzeit-Providers und Sitzungsstatus
Aufladung gekauft, Funktion aber weiterhin gesperrtPakete fügen nur Credits hinzu; prüfen Sie den Tarif und das Agent-Kontingent
API liefert 429, obwohl noch Credits vorhanden sindAnfragerate pro Schlüssel; beachten Sie die Reset- und Retry-Header
Guthaben sinkt unerwartetAktuelle Embeds, Connectors, API-Schlüssel, Indexierung, Sprache sowie Retries von Provider oder Client

Die aktuelle Kontingenttabelle finden Sie unter Tarife und Preise.