Konsole und Teams
Was jede Seite der SpicyAPI-Konsole tut und wann Sie sie brauchen, und wie Teams API-Schlüssel und Ausgabengrenzen gemeinsam nutzen, während der Team-Inhaber bezahlt.
In der Konsole unter spicyapi.ai/console verwalten Sie Ihr Konto im Webbrowser: Geld, API-Schlüssel, Logs, Teammitglieder und Einstellungen. Ihre eigenen Programme verwenden die Konsole nie. Sie rufen die API mit einem API-Schlüssel auf.
Neu hier? Folgen Sie zuerst Konto einrichten: Dort gehen Sie der Reihe nach durch Registrierung, Aufladen und das Anlegen eines Schlüssels. Diese Seite ist das Nachschlagewerk für alles Weitere in der Konsole.
Programme verwenden API-Schlüssel, nicht Ihre Anmeldung in der Konsole
Kopieren Sie niemals ein Anmelde-Cookie oder eine Sitzung der Konsole in Code. Anmeldungen laufen ab, sind an Ihren Browser gebunden und haben keine Ausgabenlimits. Legen Sie für alles Automatisierte einen API-Schlüssel an. Siehe Authentifizierung.
Sich zurechtfinden
Oben auf jeder Seite: Ihr Guthaben mit der Schaltfläche Aufladen, Modelle, Dokumentation, die Benachrichtigungsglocke und Seite finden (drücken Sie unter macOS ⌘K oder unter Windows und Linux Strg + K und tippen Sie dann den Namen einer Konsolenseite).
Links die Seitenleiste. Ganz oben sitzt die Bereichsauswahl, die festlegt, welches Konto oder welches Team Sie gerade sehen (siehe Persönlicher Bereich und Teams). Darunter sind die Seiten gruppiert:
| Gruppe | Seiten |
|---|---|
| (ohne Überschrift) | Übersicht, Abrechnung |
| Entwicklung | API-Schlüssel, Webhooks, Integrationen, Logs |
| Konto | Team, Einstellungen, Benachrichtigungen, Datenschutz |
| (unten) | Support |
Auf dem Smartphone öffnen Sie die Seitenleiste über die Menüschaltfläche.
Die Seiten der Konsole im Überblick
| Seite | Adresse | Wofür |
|---|---|---|
| Übersicht | /console | Guthaben, letzte Aktivität und eine Checkliste für den Einstieg sehen |
| Abrechnung | /console/billing | Guthaben aufladen, automatisches Aufladen einrichten, Guthabenverlauf lesen, Verbrauch ansehen, Rechnungen ausstellen |
| API-Schlüssel | /console/keys | Schlüssel anlegen, beschränken und sperren |
| Webhooks | /console/webhooks | Den Signaturschlüssel für Callbacks holen und Zustellungen prüfen |
| Integrationen | /console/integrations | Einrichtung für SDK, CLI, MCP-Server und andere Werkzeuge kopieren |
| Logs | /console/logs | Jeden Task nachschlagen: Status, Kosten, Fehler, Ergebnisse |
| Team | /console/team | Teams anlegen, Personen einladen, Ausgabengrenzen für Teams setzen |
| Einstellungen | /console/settings | Profil, Passwort, Zwei-Faktor-Authentifizierung, Geräte, Sprache der API-Fehlermeldungen, Konto schließen |
| Benachrichtigungen | /console/notifications | Warnung bei niedrigem Guthaben, Modell-Updates, welche E-Mails Sie erhalten |
| Datenschutz | /console/settings/data | Aufbewahrung von Ergebnissen, Prompts und Uploads verkürzen; Ihre Daten herunterladen |
| Support | /console/support | Vertraulich mit unserem Support-Team schreiben |
Alle Adressen beginnen mit https://spicyapi.ai. Die Adressen der Konsole haben kein Sprachpräfix.
Was jede Seite tut
Übersicht
Die erste Seite nach der Anmeldung.
- Checkliste Erste Schritte: E-Mail bestätigen, Guthaben aufladen, Ersten Task ausführen, dazu Links, um mit der API zu entwickeln oder ohne Code zu gestalten. Sind Sie fertig, blenden Sie sie mit Erste Schritte ausblenden aus.
- Verfügbares Guthaben, dazu der Betrag, der für noch laufende Tasks zurückgehalten wird, und was Sie in den letzten 7 Tagen ausgegeben haben.
- Anfragen der letzten 7 Tage und Fehler der letzten 7 Tage, mit Links zu Verbrauch ansehen und Logs ansehen.
- Zuletzt genutzte Modelle und Letzte Tasks.
- Eine Warnung, wenn das Guthaben niedrig oder leer ist. Bei leerem Guthaben werden neue Tasks abgelehnt, bis Sie aufladen; bereits angenommene Tasks laufen trotzdem zu Ende.
Abrechnung
Die Abrechnung hat drei Tabs: Überblick, Verbrauch und Rechnungen.
Abrechnung → Überblick (/console/billing)
- Guthaben aufladen per Karte, Krypto oder, wenn angeboten, per manueller Überweisung. Schritt-für-Schritt-Anleitungen, Bearbeitungszeiten und was zu tun ist, wenn eine Zahlung nicht ankommt, finden Sie unter Konto einrichten → Guthaben aufladen.
- Aufladungen: jede Aufladung mit ihrem Status (Ausstehend, Bezahlt, Storniert, Erstattet). Öffnen Sie einen ausstehenden manuellen Auftrag mit Zahlung abschließen, um seine Zahlungsanweisungen zu sehen und Ihre Transaktionsreferenz zu senden, oder wählen Sie Offenen Auftrag stornieren, wenn Sie nicht bezahlt haben.
- Automatisches Aufladen: Speichern Sie eine Karte, und wir laden auf, wenn das Guthaben knapp wird. Die genauen Regeln, auch was bei einer fehlgeschlagenen Belastung passiert, stehen unter Konto einrichten → Automatisches Aufladen.
- Guthaben im Detail: nur sichtbar, wenn Ihr Konto Bonusguthaben oder eine bewilligte Kreditlinie hat. Jede Bonusguthaben-Charge steht mit ihrem Verfallsdatum in der Liste.
- Guthabenverlauf: jede Geldbewegung, die neueste zuerst. Filtern Sie nach Art und Zeitraum oder wählen Sie CSV exportieren. Typische Einträge sind Aufladung, Bonus, Zurückgehalten (bei Annahme eines Tasks zurückgelegt), Berechnet (der endgültige Preis eines erfolgreichen Tasks), Reservierung freigegeben (der ungenutzte Teil der Reservierung geht zurück) und Zurückgezahlt (die gesamte Reservierung geht nach einem Fehler oder Timeout zurück). Wie Belastungen funktionieren, erklärt Abrechnung.
Abrechnung → Verbrauch (/console/billing/usage)
Tasks und Ausgaben pro Tag als Diagramm, für die letzten 7, 30 oder 90 Tage oder einen eigenen Zeitraum von bis zu 92 Tagen (UTC-Tage). Darunter Nach Modell: Tasks, Fehler, Ausgaben und Anteil je Modell, mit Tasks ansehen, um direkt zu diesen Tasks in den Logs zu springen. CSV exportieren lädt die angezeigten Tagessummen herunter. Der Verbrauchs-Endpunkt der API meldet nur den Schlüssel, der ihn aufruft; diese Seite zeigt den gesamten Bereich, der in der Seitenleiste ausgewählt ist.
Abrechnung → Rechnungen (/console/billing/invoices)
Tragen Sie Ihre Rechnungsdaten ein, stellen Sie eine Zahlungsrechnung für eine bezahlte Aufladung oder eine Nutzungsaufstellung für einen abgeschlossenen Monat aus, und erstellen Sie monatliche Kontoauszüge (CSV). Worin sich die Dokumente unterscheiden und wie Sie eines korrigieren, steht unter Konto einrichten → Rechnungen und Belege.
API-Schlüssel
Legen Sie die Schlüssel an, die Ihre Programme verwenden, bearbeiten und sperren Sie sie. Die Liste zeigt je Schlüssel den maskierten Wert, die bisherigen Ausgaben, die Limits, die erlaubten Modelle, die IP-Freigabeliste, den Ablauf und wann er zuletzt benutzt wurde. Suchen Sie nach Name oder maskiertem Schlüssel und filtern Sie nach Aktiv, Abgelaufen oder Gesperrt.
- Schlüssel anlegen erzeugt einen Schlüssel in dem Bereich, der in der Seitenleiste ausgewählt ist. Der vollständige Schlüssel wird ein einziges Mal angezeigt.
- Bearbeiten ändert Name, Ausgabenlimits (Tages-, Monats- und Gesamtlimit), erlaubte Modelle, IP-Freigabeliste und Ablauf. Beim Bearbeiten bedeutet ein leeres Limitfeld: kein Limit.
- Sperren stoppt einen Schlüssel sofort und lässt sich nicht rückgängig machen. Bereits angenommene Tasks laufen weiter und werden berechnet.
- Ein Schlüssel mit der Markierung Von SpicyAPI verwaltet wird von der Website verwendet, wenn Sie ein Modell auf seiner Seite ausführen.
Jedes Feld erklärt Konto einrichten → API-Schlüssel anlegen. Welche Fehlercodes die einzelnen Beschränkungen erzeugen, steht unter Authentifizierung.
Im Team: Die Schlüssel des Teams können Sie nur mit der Rolle Inhaber, Admin oder Entwickler anlegen und verwalten. Verbrauch und Grenzen eines Teamschlüssels zählen für das Team, und seine Tasks bezahlt der Team-Inhaber.
Webhooks
Ein Webhook ist eine Nachricht, die SpicyAPI an Ihren eigenen Server sendet, wenn ein Task fertig ist, damit Sie nicht ständig nachfragen müssen. Die Adresse wählen Sie pro Task mit callBackUrl. Diese Seite erledigt zwei Dinge.
Webhook-Signaturschlüssel. Jeder Callback ist signiert, damit Ihr Server prüfen kann, dass er wirklich von SpicyAPI stammt. Ihr Konto hat einen Signaturschlüssel, den alle seine API-Schlüssel gemeinsam nutzen, und sein Wert wird nur ein einziges Mal angezeigt, im Moment seiner Erzeugung. Neue Konten haben bereits einen Schlüssel, den noch niemand gesehen hat. Die Karte kann also Eingerichtet anzeigen, obwohl Sie nichts zum Kopieren haben:
- Wählen Sie Erzeugen (wenn die Karte Nicht eingerichtet zeigt) oder Erneuern (wenn sie Eingerichtet zeigt).
- Kopieren Sie den neuen Schlüssel in die Einstellungen Ihres Servers, üblicherweise als
SPICY_WEBHOOK_SECRET. - Wählen Sie Gespeichert.
Beim Erneuern gibt es keine Übergangszeit
Der alte Schlüssel signiert ab dem Moment nicht mehr, in dem Sie erneuern, und der neue gilt sofort. Solange Ihr Server den neuen Schlüssel nicht kennt, kann er keinen einzigen Callback prüfen, auch keine Wiederholungen früherer Zustellungen. Erneuern Sie in einer ruhigen Phase und aktualisieren Sie Ihren Server sofort. Verpasste Ergebnisse lassen sich weiterhin mit recordInfo abrufen. Siehe Webhooks.
Webhook-Zustellungen. Jeder Callback-Versuch für Ihr Konto, der neueste zuerst, filterbar nach Zugestellt, Wird wiederholt und Fehlgeschlagen, mit der Anzahl der Versuche und dem Zeitpunkt des nächsten Versuchs. Wiederholen sendet die ursprüngliche signierte Nachricht erneut; stellen Sie sicher, dass Ihr Server dieselbe Nachricht gefahrlos zweimal empfangen kann. Eine Zustellung, deren gespeicherter Inhalt durch Ihre Aufbewahrungseinstellungen bereits gelöscht wurde, lässt sich nicht wiederholen.
Integrationen
Einrichtung zum Kopieren und Einfügen für Werkzeuge, die mit SpicyAPI funktionieren. Wählen Sie ein Werkzeug, um seine Einrichtung zu sehen, und Doku öffnen.
- Verbindungsgrundlagen: die Basis-URL für OpenAI-kompatible Clients und eine Abkürzung Schlüssel anlegen. Benennen Sie einen Schlüssel nach dem Werkzeug, das ihn verwendet.
- Offizielle Tools: das TypeScript-SDK, die CLI, der MCP-Server und der Agent Skill.
- OpenAI-kompatible Clients: Werkzeuge, bei denen Sie die Basis-URL ändern können, für Text- und Videomodelle. Bildgenerierung gibt es über die kompatiblen Endpunkte nicht.
- Coding-Agenten: Editoren und Agenten, die den MCP-Server einbinden, der Sie jede Belastung bestätigen lässt.
Die Snippets verwenden den Platzhalter MODEL_ID_FROM_CATALOG: Ersetzen Sie ihn durch eine exakte Modell-ID aus dem Live-Katalog (GET /api/v1/models, spicyapi models list oder listModels()). Siehe Modellkatalog und Schemas.
Logs
Jeder Task, der neueste zuerst, auch fehlgeschlagene. Jede Zeile zeigt Task, Modell, Status, Dauer und Kosten.
- Filter: Status, Modell und Zeitraum. Das Suchfeld nimmt eine exakte Task-ID oder Request-ID an; so finden Sie am schnellsten den Task hinter einer Fehlermeldung. Die Seite lädt bis zu 500 Zeilen; für mehr grenzen Sie die Filter ein.
- CSV exportieren exportiert jeden Task, der zu den Filtern passt: standardmäßig die letzten 30 Tage, höchstens 92 Tage oder 10.000 Zeilen.
- Details öffnen zeigt bei einem Task seinen Status, die Kosten, Start- und Endzeit, den verwendeten Schlüssel, Task-ID und Request-ID, den Fehlercode und die Fehlerursache, die Anfrageparameter, die Antwort und Download-Links (Link holen; jeder Link läuft ab, und Sie können einen neuen erzeugen).
Das Kostenfeld zeigt während der Ausführung den reservierten Betrag und nach der Abrechnung den tatsächlichen Preis. Auch ein fehlgeschlagener Task kann bei einer auf der Modellseite ausdrücklich genannten Inhaltsablehnung kostenpflichtig sein. Lesen Sie die Abrechnung, statt aus dem Status auf eine Erstattung zu schließen.
In den Task-Details stehen drei Aktionen:
| Aktion | Was sie tut | Geld |
|---|---|---|
| Als neuen Task wiederholen | Führt dieselbe Eingabe erneut als neuen Task aus. Nur für Tasks, die fehlgeschlagen, abgelaufen oder abgebrochen sind, und nur solange ihre Eingabe noch aufbewahrt wird | Eine neue Belastung. Der ursprüngliche Datensatz bleibt unverändert |
| Ergebnisse zerstören | Löscht die erzeugten Bilder, Videos und Texte des Tasks, sein gespeichertes Ergebnis und den gesendeten Prompt. Nicht rückgängig zu machen | Nichts ändert sich: Kosten, Modell, Status, Zeitstempel und Request-ID bleiben erhalten |
| Aus Verlauf entfernen | Löscht Anfrage und Ergebnis des Tasks, stellt seine Medien zur Löschung ein und blendet die Zeile in Ihren Logs aus. Verfügbar, sobald der Task beendet und abgerechnet ist | Nichts ändert sich: Die Abrechnungsdaten bleiben erhalten |
Keine dieser Aktionen bricht einen laufenden Task ab: Angenommene Tasks lassen sich nicht abbrechen. Was beim Löschen erhalten bleibt und was entfernt wird, erklärt Datenaufbewahrung und Löschung.
Im Team: Jedes Mitglied sieht die Tasks des Teams mit Status und Kosten. Nur Inhaber, Admin und Entwickler sehen Prompts, Ergebnisse und Download-Links. Die drei Aktionen oben stehen nur dem Konto zur Verfügung, das den Task bezahlt hat.
Team
Teams anlegen, Personen einladen, Rollen ändern, Ausgabengrenzen für Teams setzen und ein Team verlassen oder übergeben. Arbeiten Sie allein? Dann brauchen Sie kein Team: Ihre Schlüssel, Ihr Guthaben und Ihr Verbrauch funktionieren schon für sich. Alles über Teams steht unten unter Teams.
Einstellungen
Eine Seite, in Gruppen gegliedert.
Konto
- E-Mail, markiert als Bestätigt oder Unbestätigt. Die Anmelde-E-Mail ändern Sie mit Anmelde-E-Mail ändern: Wir senden einen Bestätigungslink an die neue Adresse (20 Minuten gültig) und benachrichtigen die alte. Sie brauchen Ihr aktuelles Passwort.
- Anzeigename, Konto-ID (nennen Sie sie, wenn Sie den Support kontaktieren) und Mitglied seit.
Sicherheit
- Passwort. Eine Änderung meldet alle Geräte ab. Ein mit Google oder GitHub angelegtes Konto hat kein Passwort, bis Sie Einrichtungslink senden wählen und eines festlegen; ein Passwort brauchen Sie, um das Konto zu schließen oder ein Team zu übertragen.
- Angemeldete Geräte. Melden Sie jedes Gerät, das Sie nicht kennen, mit Abmelden ab, oder wählen Sie Überall abmelden (einschließlich dieses Geräts), wenn Sie vermuten, dass jemand anderes Zugriff hat. Ändern Sie direkt danach Ihr Passwort.
- Zwei-Faktor-Authentifizierung. Wählen Sie 2FA einrichten, geben Sie Ihr aktuelles Passwort ein, fügen Sie das Konto in einer Authenticator-App hinzu und geben Sie deren sechsstelligen Code ein. Ab dann verlangt jede Anmeldung einen Code. Sie erhalten außerdem zehn Wiederherstellungscodes zur einmaligen Verwendung: Bewahren Sie sie nicht auf Ihrem Smartphone auf, denn ohne das Smartphone sind sie der einzige Weg zurück ins Konto, und sie lassen sich nicht erneut anzeigen. Neue Wiederherstellungscodes ersetzt alle; 2FA ausschalten entfernt die Zwei-Faktor-Authentifizierung. Bei beidem bestätigen Sie zuerst, dass Sie es sind.
- Sicherheitsaktivitäten: letzte Anmeldungen, neue Geräte und Änderungen an Zugangsdaten.
Einstellungen
- Sprache der API-Fehlermeldungen: die Sprache von
msgin Fehlerantworten und vonerrorMessageeines Tasks (in Statusabfragen und Webhooks) für Anfragen mit Ihren API-Schlüsseln. Standard ist Englisch. Der HeaderAccept-Languageeiner Anfrage hat Vorrang, und die Codes, nach denen Sie verzweigen sollten (code,errorCode), ändern sich nie. Siehe Fehler.
Abrechnung und Daten
- Abkürzungen zu Rechnungsdaten und Kontoauszüge (unter Abrechnung → Rechnungen) und Daten und Datenschutz (die Seite Datenschutz).
Kritische Aktionen: Konto schließen
Das Schließen meldet alle Geräte ab, sperrt jeden API-Schlüssel dauerhaft und löscht erzeugte Medien und aufbewahrte Task-Inhalte. Abrechnungs-, Audit- und Abstimmungsdaten bleiben erhalten, wie in der Datenschutzerklärung beschrieben. Aufladeaufträge, die Sie nie bezahlt haben, werden für Sie storniert. Das Schließen wartet nur, solange gilt:
- Tasks sind wartend oder laufen noch, oder beendete Tasks werden noch abgerechnet (meist innerhalb einer Minute);
- eine Aufladezahlung wird noch verarbeitet (das erledigt sich von selbst, sobald der Zahlungsanbieter sie bestätigt oder freigibt, meist nach wenigen Minuten; wenden Sie sich an den Support, wenn sie nach einer Stunde noch da ist);
- das Konto schuldet Geld (genutzter bewilligter Kredit oder ein negatives Guthaben), was Sie durch Aufladen ausgleichen;
- ein Team, dessen Inhaber Sie sind, muss noch an ein anderes Mitglied übertragen oder von allen anderen Mitgliedern geleert werden.
Die Konsole listet alles auf, was noch im Weg steht. Sie bestätigen mit Ihrem aktuellen Passwort oder, falls Sie sich über Google oder einen anderen Anmeldeanbieter registriert haben und kein Passwort besitzen, mit einem 6-stelligen Code, den wir Ihnen per E-Mail senden (15 Minuten gültig).
Beim Schließen verfällt Ihr Guthaben
Restguthaben auf dem Konto verfällt. Es wird weder erstattet noch bar ausgezahlt, und die Konsole lässt Sie das ausdrücklich bestätigen. Geben Sie es vorher aus, wenn Ihnen das lieber ist. Siehe die Erstattungsrichtlinie.
Benachrichtigungen
- Warnung bei niedrigem Guthaben. Schalten Sie sie ein und wählen Sie eine Schwelle ($5, $10, $25, $50 oder $100). Fällt Ihr verfügbares Guthaben darunter, erhalten Sie eine Warnung in der Benachrichtigungsglocke und zusätzlich eine E-Mail, sofern Ihr Konto eine E-Mail-Adresse hat. Erneut gewarnt werden Sie erst, wenn das Guthaben wieder auf die Schwelle oder darüber gestiegen und danach erneut darunter gefallen ist. Das Guthaben wird etwa alle 10 Minuten geprüft.
- Updates zu Modellen, denen Sie folgen. Folgen Sie einem Modell auf seiner Seite auf spicyapi.ai; Verwalten öffnet die Liste der verfolgten Modelle und die Produkt-Updates.
- Zustellung. Benachrichtigungen in der App sind immer an. E-Mails zu Produkt-Updates und Angebote und Ankündigungen lassen sich ein- und ausschalten. Hinweise zu Sicherheit, Abrechnung und betriebskritischen Themen werden immer gesendet.
Datenschutz
- Aufbewahrung: drei getrennte Fristen für Erzeugte Ergebnisse, Prompt-Text und Hochgeladene Dateien. Sie können sie nur kürzer als die Höchstwerte der Plattform einstellen (14 Tage für Ergebnisse, 30 Tage für Prompt-Text, 24 Stunden für Uploads). Eine verkürzte Frist kann Inhalte von Tasks löschen, die Sie bereits ausgeführt haben, und zwar bei der nächsten Bereinigung, die innerhalb einer Minute läuft. Die Konsole zählt vor Ihrer Bestätigung, was betroffen ist, und gelöschte Inhalte lassen sich nicht wiederherstellen. Laden Sie vorher alles herunter, was Sie behalten möchten.
- Aufbewahrung von Task-Inhalten: eine ältere Karte mit zwei Einstellungen. Task-Inhalte aufbewahren zeigt in Tagen, wie lange Task-Inhalte aufbewahrt werden; die Dauer stellen Sie mit den drei Fristen oben ein. Inhalte kurz nach Abschluss löschen löscht die Inhalte eines beendeten Tasks etwa eine Stunde, nachdem seine Ergebnisse gespeichert und sein Webhook zugestellt wurden.
- Wohin Ihre Daten gehen: eine Zusammenfassung dessen, wozu sich die Datenschutzerklärung bereits verpflichtet, einschließlich der Zusage, dass Ihre Eingaben und Ergebnisse nicht zum Training von Modellen verwendet werden.
- Ihre Daten herunterladen: eine JSON-Datei mit Ihrem Profil, Ihren Teamrollen, Angaben zu Ihren API-Schlüsseln (nie die Schlüssel selbst), aufbewahrten Task-Daten und Abrechnungsdaten. Mediendateien sind nicht enthalten; laden Sie Ergebnisse also separat herunter.
Die vollständigen Regeln, auch die Überschreibung pro Anfrage und was beim Löschen erhalten bleibt, stehen unter Datenaufbewahrung und Löschung.
Support
Starten Sie eine vertrauliche Unterhaltung, die nur Sie und der SpicyAPI-Support lesen können. Wählen Sie Neue Unterhaltung, einen Betreff und ein Thema (Konto, Abrechnung, API-Integration, Task oder Ergebnis, Datenschutz, Unternehmen oder Anderes Thema) und beschreiben Sie, was passiert ist. Antworten erscheinen in der Unterhaltung (Status Wartet auf Support, Wartet auf Sie, Gelöst oder Geschlossen) und in der Benachrichtigungsglocke.
Helfen Sie uns, Ihnen schnell zu helfen: Nennen Sie die Task-ID, die request_id aus einer Fehlerantwort oder die Auftrags-ID der Aufladung und ungefähr, wann es passiert ist (UTC). Fügen Sie niemals einen API-Schlüssel, ein Passwort oder Kartendaten ein. Sie können auch an support@spicyapi.ai schreiben.
Teams
Persönlicher Bereich und Teams
Jedes Konto hat einen Bereich Persönlich. Niemand sonst ist darin, und wenn Sie allein arbeiten, ist er alles, was Sie brauchen: Ihre persönlichen Schlüssel, Ihr Guthaben und Ihr Verbrauch funktionieren ohne Team.
Mit einem Team teilen Kolleginnen und Kollegen API-Schlüssel, sehen denselben Task-Verlauf und arbeiten unter gemeinsamen Ausgabengrenzen. Jedes Team hat eigene Mitglieder, eigene Schlüssel und eigene Grenzen.
Die Bereichsauswahl oben in der Seitenleiste legt fest, was die Konsole zeigt:
- Persönlich: nur Ihr eigener Bereich.
- Name eines Teams: nur die Schlüssel, Tasks, der Verbrauch und die Aktivität dieses Teams.
- Alle Bereiche: alles, worauf Sie Zugriff haben, zusammengefasst.
- Neues Team: eine Abkürzung, um eines anzulegen.
Sie legt außerdem fest, wohin ein neuer API-Schlüssel gehört: Ein Schlüssel, der angelegt wird, während ein Team ausgewählt ist, gehört diesem Team.
Wer für ein Team bezahlt
Jeder Task, der mit einem API-Schlüssel eines Teams gesendet wird, wird aus dem Guthaben des Team-Inhabers bezahlt. Das ist die wichtigste Regel für Teams.
- Mitglieder laden ein Team nie auf und sehen nie Guthaben, Aufladungen, Zahlungsdaten oder Rechnungen des Inhabers.
- Sind Sie Mitglied und liefert ein Teamschlüssel plötzlich
40201, muss der Inhaber Guthaben aufladen. - Ihre eigenen persönlichen Schlüssel, Ihr Guthaben und Ihr Verbrauch werden nie mit einem Team geteilt, dem Sie beitreten, und das Verlassen eines Teams berührt sie nicht.
- Inhaber, Admins und Entwickler können Teamschlüssel anlegen, die das Guthaben des Inhabers ausgeben. Als Inhaber setzen Sie deshalb Ausgabengrenzen für das Team und geben Schlüsseln eigene Limits.
Ein Team anlegen
- Öffnen Sie Team und wählen Sie Team anlegen (oder Neues Team in der Bereichsauswahl).
- Geben Sie einen Teamnamen ein (bis zu 120 Zeichen) und wählen Sie Team erstellen.
Sie werden Inhaber des Teams. Ein Konto kann bis zu 10 Arbeitsbereiche besitzen, und Ihr persönlicher Bereich zählt als einer davon; Sie können also bis zu neun Teams anlegen. Wie vielen Teams anderer Personen Sie beitreten, ist nicht begrenzt.
Personen einladen
Nur ein Inhaber oder Admin kann einladen.
Die Einladung senden
Öffnen Sie das Team, wählen Sie Teammitglied einladen, geben Sie die E-Mail-Adresse der Person unter E-Mail der eingeladenen Person ein, wählen Sie eine Rolle (siehe Rollen und Berechtigungen; Was darf welche Rolle? zeigt eine Zusammenfassung) und wählen Sie Einladung senden.
Was Sie sehen sollten: die Einladung in der Liste als Ausstehend, mit Einladung versendet oder Einladung nicht versendet und ihrem Ablaufdatum. Die Konsole zeigt außerdem ein Einladungstoken zur einmaligen Anzeige.
Was gerade passiert ist: Wir haben einen Link an diese Adresse gesendet. Die Einladung ist 7 Tage gültig.
Falls die E-Mail nicht rausging
Zeigt die Liste Einladung nicht versendet oder kommt die E-Mail nie an, teilen Sie das Einladungstoken über einen vertrauenswürdigen privaten Kanal. Es wird nur einmal angezeigt. Wählen Sie Erneut senden, um eine neue E-Mail und ein neues Token zu erhalten: Erneutes Senden macht den alten Link und das alte Token ungültig und startet eine neue Frist von 7 Tagen.
Ihr Teammitglied nimmt an
Die Person öffnet den Link aus der E-Mail, meldet sich an oder legt zuerst ein Konto an, und zwar mit genau der E-Mail-Adresse, an die die Einladung ging, und wählt Einladung annehmen. Alternativ erscheint eine ausstehende Einladung auf ihrer Seite Team unter Einladungen für Sie mit Team beitreten, und ein Token lässt sich unter Sie haben ein Einladungs-Token? einfügen.
Was die Person sehen sollte: Sie sind dabei, und das Team erscheint in ihrer Bereichsauswahl.
Regeln für Einladungen:
- Eine Einladung kann nur ein Konto annehmen, dessen E-Mail-Adresse zur eingeladenen Adresse passt. Bei einer anderen E-Mail-Adresse erscheint „Melden Sie sich mit der eingeladenen E-Mail-Adresse an, um diese Einladung anzunehmen“ (auf Englisch
Please sign in with the invited email address to accept this invite). - Private, selbstverwaltete Konten können keinen Teams beitreten, weil sie keine E-Mail-Adresse haben.
- Pro E-Mail-Adresse und Team gibt es eine ausstehende Einladung. Wer bereits Mitglied ist, kann nicht erneut eingeladen werden.
- Ein Team kann bis zu 100 Mitglieder haben, den Inhaber eingeschlossen.
- Widerrufen storniert eine ausstehende Einladung jederzeit; dieselbe Person können Sie später erneut einladen.
- Eine abgelaufene Einladung lässt sich nicht annehmen. Senden Sie eine neue.
Rollen und Berechtigungen
Die Konsole zeigt die Rollen unter diesen Namen. API und Exporte verwenden die kleingeschriebenen Namen in Klammern.
| Was das Mitglied darf | Inhaber (owner) | Admin (admin) | Entwickler (developer) | Budgetverwalter (billing) | Nur lesen (readonly) |
|---|---|---|---|---|---|
| Tasks, Status, Kosten und Verbrauch des Teams sehen | Ja | Ja | Ja | Ja | Ja |
| Prompts und Ergebnisse lesen, Download-Links holen | Ja | Ja | Ja | Nein | Nein |
| Aktivität des Teams sehen (Geldbewegungen aus Team-Tasks) | Ja | Ja | Nein | Ja | Nein |
| API-Schlüssel des Teams anlegen, bearbeiten und sperren | Ja | Ja | Ja | Nein | Nein |
| Assets in Generierungen verwenden (Team-Bibliothek) | Ja | Ja | Ja | Ja | Ja |
| In der Team-Asset-Bibliothek speichern | Ja | Ja | Ja | Nein | Nein |
| Team-Assets umbenennen oder löschen | Ja | Ja | Nur selbst gespeicherte Assets | Nein | Nein |
| Ausgabengrenzen des Teams ändern | Ja | Ja | Nein | Ja | Nein |
| Personen einladen, Einladungen erneut senden oder widerrufen | Ja | Ja, aber keine Admins einladen | Nein | Nein | Nein |
| Rollen ändern und Mitglieder entfernen | Ja | Ja, aber nicht bei anderen Admins und niemanden zum Admin machen | Nein | Nein | Nein |
| Team umbenennen | Ja | Ja | Nein | Nein | Nein |
| Eigentümerschaft übertragen | Ja | Nein | Nein | Nein | Nein |
| Team verlassen | Nein, erst übertragen | Ja | Ja | Ja | Ja |
Außerdem:
- Niemand kann die eigene Rolle ändern. Die Rolle des Inhabers ändert sich nur durch eine Übertragung.
- Einen Task wiederholen, seine Ergebnisse zerstören oder ihn entfernen kann nur das Konto, das ihn bezahlt hat, unabhängig von der Rolle.
- Ein Mitglied, dessen Rolle keine Inhalte lesen darf, sieht Mit Ihrer Rolle sehen Sie Task-Status und Verbrauch, aber keine Prompts und keine Ergebnisse.
- Außer dem Inhaber sieht nie jemand dessen persönliches Guthaben, Aufladungen, Zahlungsdaten oder Rechnungen. Aktivität des Teams listet nur Geldbewegungen, die durch Tasks des Teams entstanden sind.
Ausgabengrenzen für Teams
Jedes Team (und Ihr persönlicher Bereich) hat eine tägliche und eine monatliche Grenze in US-Dollar, unter Team → Ihr Team → Ausgabengrenzen. Inhaber, Admins und Budgetverwalter ändern sie mit Bearbeiten und dann Grenzen speichern.
- Sie gelten für alle Tasks zusammen, die mit den Schlüsseln dieses Bereichs gesendet werden.
- Bereits berechnetes Geld und für noch laufende Tasks reserviertes Geld zählen beide.
- Die tägliche Grenze beginnt um 00:00 UTC neu, die monatliche am 1. jedes Monats um 00:00 UTC.
- Standard ist Kein Limit. Geben Sie
0für keine Grenze ein. Ein leer gelassenes Feld behält seinen aktuellen Wert. - Ein Task, der eine Grenze überschreiten würde, wird mit
40202und der MeldungWorkspace daily budget has been reachedoderWorkspace monthly budget has been reachedabgelehnt. Es wird nichts angelegt und nichts reserviert.
Teamgrenzen gelten zusätzlich zu den eigenen Tages-, Monats- und Gesamtlimits jedes Schlüssels und zum Guthaben des Inhabers. Was zuerst erschöpft ist, stoppt den Task. Alle Ausgabenlimits erklärt Abrechnung.
Rollen ändern und Mitglieder entfernen
Öffnen Sie das Team. Wählen Sie unter Mitglieder eine neue Rolle für ein Mitglied und bestätigen Sie mit Rolle ändern; die Änderung gilt sofort. Entfernen nimmt ein Mitglied sofort aus dem Team: Es verliert den Zugriff auf das Team, seine Schlüssel und seine Aktivität. Der Inhaber lässt sich nicht entfernen.
Das Entfernen eines Mitglieds sperrt keine Schlüssel, die es angelegt oder verwendet hat. Teamschlüssel gehören dem Team; sperren Sie also auf der Seite API-Schlüssel jeden Schlüssel, den diese Person noch hat.
Ein Team verlassen
Jedes Mitglied außer dem Inhaber kann gehen: Öffnen Sie das Team, wählen Sie Team verlassen und bestätigen Sie. Der Zugriff endet sofort, und nur eine neue Einladung bringt Sie zurück.
Es wird nichts gelöscht. Schlüssel, Tasks und Verbrauch des Teams bleiben beim Team und werden weiterhin seinem Inhaber berechnet. Haben Sie noch einen seiner Schlüssel, bitten Sie einen Admin, ihn zu sperren. Ihr persönlicher Bereich bleibt unberührt.
Der Inhaber kann nicht einfach gehen, denn die Schlüssel des Teams würden weiter das Geld des Inhabers ausgeben, ohne dass jemand sie verwalten könnte. Übertragen Sie zuerst die Eigentümerschaft. Sind Sie das einzige Mitglied, laden Sie jemanden ein und übergeben Sie das Team an diese Person.
Eigentümerschaft übertragen
Nur der Inhaber kann übertragen, und nur an jemanden, der bereits Mitglied ist.
- Öffnen Sie das Team und gehen Sie zu Kritische Aktionen → Eigentümerschaft übertragen.
- Wählen Sie unter Neuer Inhaber das Mitglied aus und geben Sie unter Aktuelles Passwort Ihr Passwort ein. (Ein mit Google oder GitHub angelegtes Konto muss zuerst unter Einstellungen ein Passwort festlegen.)
- Prüfen Sie alles und wählen Sie Team übertragen.
Ab diesem Moment gilt:
- Das Guthaben des neuen Inhabers bezahlt jeden Task, der mit den Schlüsseln des Teams gesendet wird, und alle Teamschlüssel wechseln in das Konto des neuen Inhabers;
- Sie werden Admin;
- Tasks, die vor der Übertragung angenommen wurden, behalten ihre ursprüngliche Abrechnung und werden nicht abgebrochen.
Ein Team löschen
Ein Team lässt sich nicht löschen. Ein ungenutztes Team kostet nichts und erscheint nie auf einer Rechnung. Entfernen Sie seine Mitglieder und lassen Sie es ruhen, oder benennen Sie es um und verwenden Sie es weiter, statt ein neues anzulegen.
Grenzen für Teams im Überblick
| Grenze | Wert |
|---|---|
| Arbeitsbereiche, die ein Konto besitzen kann | 10, den persönlichen Bereich eingeschlossen |
| Mitglieder pro Team | 100, den Inhaber eingeschlossen |
| Gültigkeit einer Einladung | 7 Tage; erneutes Senden startet eine neue Frist von 7 Tagen |
| Aktive API-Schlüssel pro Bereich | 50 |
| Teamname | 1 bis 120 Zeichen |
Abrechnung
SpicyAPIs nutzungsbasierte USD-Abrechnung: Preisabfragen, Reservierungen, endgültige Kosten, modellspezifische Ablehnungen, Aufladungen, Ausgabenlimits und Rechnungen.
Aufbewahrung und Löschung
Obergrenzen der Plattform, kürzere Einstellungen, ihre Wirkung auf vorhandene Inhalte, gezielte Tasklöschung und die Grenzen unserer Zusagen.

