Unternehmenskonten

Mit einem Unternehmenskonto gibt ein ganzes Team Geld aus einem gemeinsamen Guthaben aus. Das Guthaben des Inhaberkontos wird zum Unternehmensguthaben, jedes Mitglied ruft die API mit einem eigenen Schlüssel auf, und jede Abbuchung geht von diesem gemeinsamen Guthaben ab. Endpunkte, Request-Bodys und Client-Einrichtung sind dieselben wie bei einem persönlichen Konto; diese Seite beschreibt nur, was sich ändert, wenn der Aufrufer zu einem Unternehmen gehört.

Ein Mitglied sendet eine Anfrage

acme-…

Mit dem eigenen Schlüssel, der mit dem Unternehmenspräfix beginnt.

Budgetprüfung

Die geschätzten Kosten müssen in das restliche Budget des Mitglieds passen.

Dem Unternehmen belastet

Zu den Preisen, Gruppen und dem Abonnement des Inhaberkontos.

Dem Mitglied zugeordnet

Inhaber und Admins können sie nach Mitglied, Modell, Schlüssel und Datum aufschlüsseln.

Mitglieder verfügen nie über eigenes Geld. Ein Budget begrenzt nur, wie viel sie vom Unternehmensguthaben ausgeben können.

Rollen

Rolle	Konto	Was sie darf
Inhaber	Das Konto, das den Antrag gestellt hat	Sein Guthaben ist das Unternehmensguthaben. Verwaltet alle, lädt Guthaben auf und sieht die Nutzung des gesamten Unternehmens. Kann nicht deaktiviert werden.
Admin	Über eine Einladung erstellt	Ruft die API im Rahmen eines Budgets auf, lädt Mitglieder ein und verwaltet sie, lädt Guthaben auf und sieht die Nutzung des gesamten Unternehmens.
Mitglied	Über eine Einladung erstellt	Nutzt die API, die Bild- und Video-Workbench und Castaly im Rahmen eines Budgets. Kann kein Guthaben aufladen.

Admins und Mitglieder sind neue Konten, die über eine E-Mail-Einladung erstellt werden. Die eingeladene E-Mail-Adresse darf noch nicht registriert sein, daher kann ein bestehendes persönliches Konto keinem Unternehmen beitreten. Diese Konten nehmen nicht an Prämienaktionen der Plattform teil.

Inhaber und Admins können ein Konto jederzeit deaktivieren; seine Sitzungen und Schlüssel funktionieren dann sofort nicht mehr. Konten werden nur deaktiviert, nie gelöscht, daher bleibt ihr Nutzungsverlauf erhalten.

API-Schlüssel

Unternehmensschlüssel beginnen mit dem Schlüsselpräfix des Unternehmens, zum Beispiel acme- gefolgt von 48 Buchstaben und Ziffern. Das Präfix wählen Sie im Antrag; es wird bei der Genehmigung festgelegt und kann danach nicht mehr geändert werden. Ein Präfix besteht aus 2 bis 16 Kleinbuchstaben und Ziffern und beginnt mit einem Buchstaben.

Derselbe Schlüssel funktioniert auch mit sk- anstelle des Präfixes. Verwenden Sie diese Schreibweise für Clients, die nur Schlüssel akzeptieren, die mit sk- beginnen: Beide Schreibweisen sind derselbe Schlüssel, mit denselben Berechtigungen und derselben Abrechnung.

Text

Authorization: Bearer acme-<48 characters>
Authorization: Bearer sk-<48 characters>

Ein Schlüssel, der mit einem Präfix gesendet wird, das nicht zu seinem eigenen Unternehmen gehört, wird als ungültiger Schlüssel mit 401 abgelehnt.

Schlüssel, die der Inhaber vor der Genehmigung des Antrags erstellt hat, werden ebenfalls mit dem Unternehmenspräfix angezeigt. Ihre Schreibweise mit sk- funktioniert weiter, bestehende Integrationen müssen also nicht geändert werden.

Admins und Mitglieder erstellen und sehen in der Konsole nur ihre eigenen Schlüssel. Inhaber und Admins können alle Schlüssel des Unternehmens in der Unternehmenskonsole verwalten, gefiltert nach Mitglied.

Mitgliederbudgets

Jeder Admin und jedes Mitglied hat ein Budget. Es wird kein Geld an sie übertragen; das Budget ist der Höchstbetrag, den sie vom Unternehmensguthaben ausgeben dürfen.

Modus	Verhalten
Unbegrenzt	Nur durch das Unternehmensguthaben begrenzt.
Einmalig	Ein fester Betrag, der sich nie von selbst zurücksetzt.
Monatlich	Beginnt am 1. jedes Monats um 00:00 UTC wieder bei null.

Wird nur das Limit geändert, bleibt der bereits verbrauchte Betrag erhalten. Ein Wechsel in einen anderen Modus beginnt die Zählung wieder bei null.

Bevor eine Anfrage ausgeführt wird, reserviert das Gateway ihre geschätzten Kosten vom verbleibenden Budget des Mitglieds und lehnt die Anfrage ab, wenn sie nicht hineinpasst. Anschließend wird die Anfrage zu ihren tatsächlichen Kosten abgerechnet. Die Abrechnung lehnt nie ab, daher kann die letzte Anfrage ein Mitglied knapp über das Limit bringen; die nächste wird abgelehnt. Schlägt eine Anfrage fehl oder wird sie erstattet, fließt der Betrag auch in das Budget des Mitglieds zurück.

Mitglieder erhalten eine E-Mail, wenn sie 80 % ihres Budgets verbraucht haben, und noch einmal, wenn es aufgebraucht ist.

Abrechnung, Gruppen und Ratenbegrenzung

Für das Gateway ist die Anfrage eines Mitglieds eine Anfrage des Inhaberkontos. Alles außer dem Budget richtet sich nach dem Inhaber:

• Abbuchungen erfolgen vom Unternehmensguthaben genauso wie beim Inhaber selbst, einschließlich des Abonnements des Inhabers.
• Preise, Gruppen und die Modelle, die ein Schlüssel aufrufen kann, sind die des Inhaberkontos.
• Ratenbegrenzungen gelten für das gesamte Unternehmen. Inhaber und alle Mitglieder teilen sich ein Kontingent, daher kann ein 429 durch den Traffic anderer verursacht werden.

Ist das Unternehmensguthaben aufgebraucht, schlagen die Anfragen aller Personen im Unternehmen mit 403 und insufficient_user_quota fehl, wie bei einem persönlichen Konto. Inhaber und Admins können über die Unternehmenskonsole aufladen, Mitglieder nicht. Ist eine Guthabenwarnung eingerichtet, erhalten Inhaber und Admins eine E-Mail, sobald das Guthaben darunter fällt.

Fehler

Situation	Status	Woran man es erkennt
Der Schlüssel trägt das Präfix eines anderen Unternehmens	401	Als ungültiger Schlüssel abgelehnt
Das Budget des Mitglieds ist aufgebraucht	403	code ist enterprise_member_budget_exhausted
Das Mitglied wurde deaktiviert oder das Unternehmen gesperrt	403	message meldet, dass das Konto deaktiviert ist
Das Unternehmensguthaben ist aufgebraucht	403	code ist insufficient_user_quota
Das Unternehmen als Ganzes hat eine Ratenbegrenzung erreicht	429	Wie bei einem persönlichen Konto

Erneute Versuche beheben die Fälle 401 und 403 nicht. Ein Budgetfehler verschwindet, wenn ein Admin das Limit erhöht oder bei einem monatlichen Budget der nächste Monat beginnt; ein Guthabenfehler verschwindet nach einer Aufladung.

Asynchrone Aufgaben

Eine mit dem Schlüssel eines Mitglieds eingereichte Aufgabe kann nur mit den Schlüsseln dieses Mitglieds abgefragt werden. Eine Abfrage mit dem Schlüssel eines anderen Mitglieds liefert dasselbe Ergebnis wie für eine Aufgabe, die nicht existiert. Die Schlüssel des Inhabers können Aufgaben aller Personen im Unternehmen abfragen.

Nutzung und Logs

• Jeder Anfrage-Logeintrag hält fest, welches Mitglied die Anfrage gesendet hat.
• In ihrer eigenen Konsole sehen Admins und Mitglieder nur ihre eigenen Anfragen.
• Die Log-Seite des Inhabers zeigt Anfragen aus dem gesamten Unternehmen, mit einer zusätzlichen Spalte „Mitglied“.
• Inhaber und Admins können die Ausgaben in der Unternehmenskonsole nach Mitglied, Modell, Schlüssel und Datum aufschlüsseln und die einzelnen Anfragen jedes Mitglieds öffnen.
• Wie weit das zurückreicht, richtet sich nach der Log-Aufbewahrung des Inhaberkontos, siehe Datenaufbewahrung. Verkürzt der Inhaber sie, verkürzen sich auch die Unternehmensberichte.

Ein Unternehmenskonto erhalten

Stellen Sie den Antrag in der Modelflare-Konsole mit dem Unternehmensnamen, dem gewünschten Schlüsselpräfix und einer Kontakt-E-Mail-Adresse. Nach der Genehmigung wird Ihr Konto zum Inhaber, sein Guthaben wird zum Unternehmensguthaben, und Sie laden Ihr Team über die Unternehmenskonsole ein. Die Seite Für Unternehmen beschreibt das vollständige Angebot.