Konto einrichten

Konto erstellen und E-Mail-Adresse bestätigen

Öffnen Sie spicyapi.ai/register. Es gibt drei Wege, sich zu registrieren:

Setzen Sie das Häkchen für die Zustimmung zu den Nutzungsbedingungen und der Datenschutzerklärung und wählen Sie dann Konto erstellen.

Was Sie sehen sollten: bei einem E-Mail-Konto eine Seite mit dem Titel Prüfen Sie Ihren Posteingang. Öffnen Sie die E-Mail und klicken Sie auf den Link. Die Seite E-Mail bestätigt bestätigt das, und Zur Konsole bringt Sie hinein.

Was gerade passiert ist: Ihr Konto existiert, kann die API aber erst aufrufen, wenn die E-Mail-Adresse bestätigt ist. Bis dahin zeigt die Konsole das Banner E-Mail nicht bestätigt – API-Aufrufe werden abgewiesen.

• Der Link funktioniert einmal und läuft nach 24 Stunden ab. Ist er abgelaufen, öffnen Sie ihn trotzdem und nutzen Sie Neuen Bestätigungslink senden, oder wählen Sie Bestätigen im Banner der Konsole.
• Nach ein paar Minuten ist nichts angekommen? Prüfen Sie Ihren Spam-Ordner und nutzen Sie dann Erneut senden.

Guthaben aufladen

Öffnen Sie in der Konsole Abrechnung: spicyapi.ai/console/billing. Unter Guthaben aufladen:

1. Betrag wählen. Nehmen Sie einen der vorgegebenen Beträge (zum Beispiel $10, $25, $50 oder $100) oder Eigener Betrag und geben Sie selbst einen ein. Die Konsole zeigt den kleinsten und den größten Betrag, den Sie mit einer Zahlung aufladen können. Online-Zahlungen erlauben höchstens zwei Nachkommastellen.
2. Auf einen Bonus achten. Manche Beträge kommen mit einem Aktionsbonus, der vor dem Bezahlen als +$… Bonus angezeigt wird. Der Bonus wird als eigener Eintrag neben dem bezahlten Betrag gebucht.
3. Zahlungsart wählen und dem passenden Tab unten folgen.

Weitere Meldungen, die Sie sehen können:

• Aufladung nicht verfügbar oder Ein Aufladeauftrag kann derzeit nicht erstellt werden: Aufladungen sind vorübergehend geschlossen, oder Sie haben zu viele offene Aufträge. Schließen Sie die alten unter Aufladungen ab oder stornieren Sie sie, oder versuchen Sie es später erneut.
• Die Verbindung brach ab, das Ergebnis ist offen: Sehen Sie unter Aufladungen nach, bevor Sie es erneut versuchen, damit Sie nicht doppelt bezahlen.

Optional: automatisches Aufladen einschalten

Das automatische Aufladen belastet für Sie eine gespeicherte Karte, wenn Ihr Guthaben knapp wird, damit lange Aufträge nicht mittendrin mit 40201 stehen bleiben. Es funktioniert nur mit einer Karte.

1. Suchen Sie in Abrechnung den Bereich Automatisches Aufladen und wählen Sie Zahlungsart sicher speichern.
2. Geben Sie Ihre Karte auf der sicheren Seite ein, die sich öffnet. Ihre Kartendaten bleiben beim Zahlungsdienstleister.
3. Zurück in Abrechnung sehen Sie Wir prüfen deine Zahlungsmethode und danach Zahlungsmethode gespeichert. Sehen Sie Diese Karte funktioniert hier nicht, wurde nichts gespeichert; versuchen Sie es mit einer anderen Karte.
4. Füllen Sie drei Felder aus:
   • Aufladen unter: das Guthaben, bei dem eine Belastung ausgelöst wird.
   • Betrag je Aufladung: wie viel jede Belastung auflädt. Der Betrag muss im selben Rahmen liegen wie bei einer normalen Aufladung.
   • Monatslimit: der Höchstbetrag, den das automatische Aufladen in einem Kalendermonat belasten darf. Es darf nicht niedriger sein als der Betrag je Aufladung.
5. Setzen Sie das Häkchen bei der Autorisierung und wählen Sie Automatisches Aufladen einschalten.

Was Sie sehen sollten: Automatisches Aufladen ist jetzt mit diesen Limits aktiv. Der Bereich zeigt die Regel, zum Beispiel „Lädt $50 auf, sobald Ihr Guthaben unter $10 fällt“, und Diesen Monat genutzt.

Die Regeln im Einzelnen:

• Wir prüfen Ihr Guthaben etwa alle 30 Sekunden bis 2 Minuten. Liegt Ihr verfügbares Guthaben auf oder unter dem Schwellenwert, belasten wir die gespeicherte Karte mit dem eingestellten Betrag.
• Jede Belastung ist ein normaler Aufladeauftrag mit der Kennzeichnung Automatisch. Sie erhält denselben Bonus wie eine manuelle Aufladung über denselben Betrag, und Sie können dafür eine Rechnung ausstellen.
• Das Monatslimit zählt Kalendermonate in UTC. Ist es ausgeschöpft, wartet das automatische Aufladen bis zum 1. des nächsten Monats. Fehlgeschlagene Belastungen zählen nicht auf das Limit.
• Schlägt eine Belastung fehl, versuchen wir es nach 1 Stunde erneut und dann noch einmal nach 6 Stunden. Scheitert auch der dritte Versuch in Folge, schaltet sich das automatische Aufladen selbst aus. Lehnt die Bank die Karte grundsätzlich ab (zum Beispiel bei einer gestohlenen oder gekündigten Karte), schaltet es sich sofort aus. Eine erfolgreiche Belastung setzt die Zählung zurück.
• Hat es sich selbst ausgeschaltet, bringen Sie die Karte in Ordnung (oder speichern Sie eine neue) und schalten Sie es wieder ein.
• Automatisches Aufladen ausschalten stoppt künftige Belastungen jederzeit. Ihr Guthaben und bereits durchgeführte Aufladungen bleiben davon unberührt.

API-Schlüssel anlegen

Öffnen Sie API-Schlüssel: spicyapi.ai/console/keys und wählen Sie Schlüssel anlegen (oder Ersten Schlüssel anlegen).

Im Dialog API-Schlüssel anlegen ist nur der Name Pflicht. Alles unter Erweitert lässt sich später ändern.

Name. Benennen Sie den Schlüssel nach dem, was ihn verwenden wird, etwa production backend oder my laptop. Beim Sperren müssen Sie ihn wiedererkennen. Bis zu 120 Zeichen.

Ausgabenlimits (unter Erweitert, in US-Dollar). Ist ein Limit erreicht, lehnt dieser Schlüssel neue Tasks mit 40202 ab, bis der Zeitraum neu beginnt. Ihre anderen Schlüssel funktionieren weiter. Beträge, die für noch laufende Tasks reserviert sind, zählen auf jedes Limit.

Geben Sie in einem der Limitfelder 0 ein, gilt dort kein Limit; ein leeres Feld bedeutet dasselbe.

Zugriff.

• Erlaubte Modelle. Belassen Sie es bei Alle Modelle (ohne Einschränkung), kann der Schlüssel jedes Modell aufrufen, auch später hinzugekommene. Wählen Sie bestimmte Modelle aus, lehnt der Schlüssel jedes andere Modell mit 40301 ab.
• IP-Freigabeliste. Alle Adressen nimmt Aufrufe von überall an. Nur diese nimmt nur Aufrufe von den Adressen an, die Sie eintragen: IPv4, IPv6 oder CIDR-Bereiche wie 203.0.113.10, 198.51.100.0/24, durch Kommas getrennt, bis zu 64 Einträge. Tragen Sie die öffentliche Adresse ein, von der Ihr Server aufruft, nicht eine Adresse aus Ihrem Büro- oder Heimnetz. Aufrufe von anderswo werden mit 40302 abgelehnt. Für einen Laptop, dessen Adresse wechselt, lassen Sie Alle Adressen stehen.
• Ablauf. Wählen Sie 7, 30 oder 90 Tage, 1 Jahr, Nie oder ein genaues Datum. Der Schlüssel hört am Ende dieses Tages (UTC) auf zu funktionieren und erhält ab dann dieselbe 401 wie ein gesperrter Schlüssel.

Wählen Sie Schlüssel anlegen.

Was Sie sehen sollten: einen Dialog Schlüssel angelegt mit dem vollständigen Schlüssel, der mit sk-spicy- beginnt. Kopieren Sie ihn mit Schlüssel kopieren oder wählen Sie Als Datei speichern. Setzen Sie das Häkchen bei Ich habe diesen Schlüssel sicher abgelegt und wählen Sie dann Fertig.

Was gerade passiert ist: Dies ist das einzige Mal, dass der vollständige Schlüssel angezeigt wird. Wir speichern davon nur einen Einweg-Hash, deshalb kann ihn Ihnen niemand erneut anzeigen, auch unser Support-Team nicht. Geht er verloren, sperren Sie ihn und legen Sie einen neuen an.

Später auf derselben Seite:

• Bearbeiten ändert Name, Limits, erlaubte Modelle, IP-Freigabeliste und Ablauf. Änderungen wirken sofort.
• Sperren stoppt den Schlüssel sofort und lässt sich nicht rückgängig machen. Bereits angenommene Tasks laufen weiter und werden weiterhin berechnet.
• In einem Bereich können Sie bis zu 50 aktive Schlüssel haben. Verwenden Sie einen Schlüssel pro App oder Umgebung, damit Sie einen sperren können, ohne die anderen zu stoppen.

Den Schlüssel in SPICY_API_KEY ablegen

Eine Umgebungsvariable ist ein benannter Wert, den Ihr Terminal an die Programme weitergibt, die es startet. Das offizielle SDK, die CLI und der MCP-Server sowie jedes Beispiel in dieser Dokumentation lesen Ihren Schlüssel aus einer Variable namens SPICY_API_KEY. So muss der Schlüssel nie in einen Befehl getippt oder in einem Projekt gespeichert werden.

Öffnen Sie zuerst ein Terminal: Unter macOS drücken Sie Cmd + Leertaste, tippen Terminal und drücken Enter. Unter Windows öffnen Sie das Start-Menü, tippen PowerShell und öffnen Windows PowerShell.

export SPICY_API_KEY="sk-spicy-paste-your-key-here"

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

Auf einem Server setzen Sie SPICY_API_KEY in den Secret- oder Umgebungseinstellungen Ihres Hosting-Anbieters statt in einer Datei in Ihrem Projekt.

Kostenlosen Testaufruf machen

Dieser Aufruf fragt Ihr Guthaben ab. Er kostet nichts, legt nichts an und belegt drei Dinge auf einmal: Der Schlüssel ist gesetzt, der Schlüssel ist gültig, und Ihr Konto darf die API aufrufen.

curl https://api.spicyapi.ai/api/v1/chat/credit \
  -H "Authorization: Bearer $SPICY_API_KEY"

Erwartet: eine Antwort wie diese (gekürzt):

{
  "code": 200,
  "msg": "success",
  "data": {
    "available": "25",
    "held": "0",
    "total": "25"
  },
  "request_id": "req_01k..."
}

Was das bedeutet: "code": 200 heißt Erfolg. Beträge sind US-Dollar, als Text geschrieben. available ist, was Sie für neue Generierungen ausgeben können, held ist für noch laufende Generierungen reserviert, und total ist beides zusammen. Die echte Antwort enthält außerdem ein Objekt funding, das bezahlte Mittel von eventuellem Bonusguthaben aus Aktionen trennt; das können Sie vorerst ignorieren.

Wenn Sie etwas anderes erhalten:

Sie möchten lieber ohne curl arbeiten? Die CLI erledigt dasselbe mit spicyapi balance.