Zum Hauptinhalt springen

Nutzung

Der Nutzungs-Service erfasst den Ressourcenverbrauch ueber Workspaces hinweg -- einschliesslich Wortverbrauch, Bildgenerierungs-Credits und anderer gemessener Funktionen.

Konzepte​

Was wird erfasst​

Der Nutzungs-Service erfasst zwei Arten von Ressourcenverbrauch in Ihrem Workspace:

Tokens — Jede Textgenerierungsanfrage verbraucht Tokens, die sowohl ueber die neuroflash-Oberflaeche als auch ueber die API gezaehlt werden. Der Token-Verbrauch wird sowohl gegen ein monatliches als auch ein taegliches Limit angerechnet. Das taegliche Limit wird um Mitternacht UTC zurueckgesetzt; das monatliche Limit wird zu Beginn jedes Abrechnungszeitraums zurueckgesetzt.

Bilder — Jedes generierte Bild (Text-zu-Bild oder Bild-zu-Bild) verbraucht einen Bild-Credit. Der Bildverbrauch folgt der gleichen Struktur aus monatlichem und taeglichem Limit wie Tokens.

API und UI teilen dieselben Kontingente​

Es gibt kein separates Kontingent fuer die API-Nutzung. Aufrufe ueber die REST-API, den MCP-Server oder jede andere Integration werden aus denselben Workspace-Kontingenten abgezogen wie die Nutzung ueber die neuroflash-App. Wenn Ihr Workspace sein Token- oder Bildlimit erreicht, sind sowohl die Oberflaeche als auch die API betroffen, bis das Limit zurueckgesetzt oder der Plan aktualisiert wird.

Fair-Use-Richtlinie​

Jeder Nutzungstyp hat ein Fair-Use-Limit. Sobald diese Schwelle erreicht ist, wird fairUseLimitReached in der Kontingentantwort auf true gesetzt. Das Ueberschreiten des Fair-Use-Limits kann je nach Abonnement zu einer Drosselung fuehren.

Kontingente​

Jeder Workspace hat Kontingente pro Nutzungstyp, die Folgendes erfassen:

  • Limitbetrag — Maximal erlaubte Nutzung pro Abrechnungszeitraum
  • Taeglicher Limitbetrag — Maximal erlaubte Nutzung pro Tag
  • Verbrauchter Betrag — Gesamtverbrauch im aktuellen Abrechnungszeitraum
  • Taeglich verbrauchter Betrag — Heute verbraucht
  • Verfuegbarer Betrag — Verbleibende Kapazitaet im aktuellen Zyklus
  • Bonusbetrag — Zusaetzliche Credits ueber die Planbasis hinaus
  • Uebertragungsbetrag — Ungenutzte Credits aus dem vorherigen Zyklus

Ressourcenlimits auf Planebene​

Zusaetzlich zu Token- und Bildkontingenten sind einige Ressourcen auf Planebene begrenzt:

RessourceSo pruefen Sie
MarkenstimmenGET /brand-voice-service/v1/workspaces/{id}/brand-voice-limits
ZielgruppenGET /audience-service/v1/workspaces/{id}/audience-limits

Diese Limits sind unabhaengig von Token-/Bildkontingenten. Der Versuch, eine Ressource ueber das Planlimit hinaus zu erstellen, gibt 403 Forbidden mit einer beschreibenden Fehlermeldung zurueck. Pruefen Sie die aktuelle Nutzung und Limits, bevor Sie neue Ressourcen erstellen.

Endpoints​

Base Path: https://app.neuroflash.com/api/usage-service

MethodeEndpointBeschreibung
GET/v1/workspaces/{id}/quotasWorkspace-Kontingente auflisten
POST/v1/workspaces/{id}/usagesNutzungsereignis erfassen
GET/v1/usage-typesAlle Nutzungstypen auflisten