So funktioniert SpicyAPI

Wenn Sie neu sind, fangen Sie hier an. Diese Seite erklärt in einfachen Worten, was SpicyAPI macht, hilft Ihnen, den passenden Weg zu wählen, und stellt die wenigen Grundbegriffe vor, die der Rest dieser Dokumentation voraussetzt. Programmierkenntnisse brauchen Sie dafür nicht.

Was SpicyAPI ist

Mit SpicyAPI erhalten Sie einen einzigen API-Schlüssel für Bild-, Video- und Textmodelle vieler verschiedener Modellhersteller und zahlen pro Nutzung in US-Dollar.

Ohne SpicyAPI bedeutet die Arbeit mit mehreren KI-Modellen: bei jedem Unternehmen ein eigenes Konto eröffnen, jedes Anfrageformat einzeln lernen und jedes Guthaben getrennt aufladen. Mit SpicyAPI haben Sie ein Konto und ein Guthaben. Sie wählen ein Modell, senden Ihren Prompt (und ein Referenzbild, falls das Modell eines annimmt) und erhalten ein Bild, ein Video oder Text zurück. Wechseln Sie zu einem anderen Modell, ändert sich nichts daran, wie Sie eine Anfrage absenden oder das Ergebnis abholen.

• Ein Schlüssel, viele Modelle. Alle Bild- und Videomodelle nutzen Sie auf dieselbe Weise: Task absenden, danach das Ergebnis abholen. Textmodelle akzeptieren zusätzlich die Anfrageformate der offiziellen Bibliotheken von OpenAI, Anthropic und Google Gemini.
• Bezahlung pro Nutzung, in Dollar. Je nach Modell gilt der Preis pro Bild, pro Sekunde Video, pro Anfrage oder pro Token. Es gibt kein Abo und kein System aus Credits oder Punkten: Der angezeigte Preis ist der Dollarbetrag, der von Ihrem Guthaben abgeht. Einen kostenlosen Tarif gibt es ebenfalls nicht, Sie laden also vor Ihrer ersten Generierung Guthaben auf. Siehe Abrechnung.
• Sobald ein Task angenommen ist, wird der geschätzte Betrag in Ihrem Guthaben reserviert. Ist der Task erfolgreich, zahlen Sie das, was er tatsächlich verbraucht hat, und nie mehr als diesen Betrag. Bei fehlgeschlagenen oder abgelaufenen Tasks wird die Reservierung normalerweise vollständig freigegeben. Einige Inhaltsablehnungen werden zum angenommenen Angebotspreis berechnet, sofern die Modellseite diese Ausnahme ausdrücklich nennt. Prüfen Sie den endgültigen Betrag anhand von settled und cost.
• Kein Inhaltsschalter nötig. SpicyAPI verlangt in der Anfrage kein Flag für einen Inhaltsmodus und prüft Inhalte nicht bei jeder einzelnen Anfrage. Was ein Modell erzeugt, hängt vom Modell selbst ab: Manche lehnen bestimmte Anfragen ab oder schwächen das Ergebnis ab. Wie Sie das Erzeugte verwenden, bleibt Ihre Verantwortung; siehe Inhalte und Nutzungsverantwortung.

Festlandchina bedient SpicyAPI nicht, und auch einige weitere Regionen sind gesperrt; siehe dieselbe Richtlinienseite.

Was Sie erstellen können

Der Katalog enthält außerdem einige speziellere Video-Tasks, etwa eine Figur mit der Bewegung aus einem anderen Clip zu animieren oder einen vorhandenen Clip zu verlängern. Modelle kommen mit der Zeit hinzu und werden auch wieder eingestellt; was es heute gibt, entscheidet deshalb immer der Live-Katalog.

Die aktuellen Modelle mit Bildern, Beschreibungen und Preisen finden Sie unter spicyapi.ai/explore. Dieselbe Liste gibt es auch ohne Konto und ohne Schlüssel als rohes JSON, falls Sie sie in einem Terminal ansehen möchten:

curl "https://api.spicyapi.ai/console/v1/catalog/models?locale=en&strict=1"

Der Befehl gibt einen langen Textblock aus. Jedes Modell darin hat eine modality (image, video oder text), seine tasks und einen Einstiegspreis price. Diese öffentliche Liste ist zum Stöbern gedacht. Sobald Sie einen Schlüssel haben, liefert GET /api/v1/models die Liste der Modelle, die Ihr Schlüssel tatsächlich aufrufen kann. Siehe Katalog im Glossar.

Wählen Sie Ihren Weg

Es gibt fünf Einstiege. Alle teilen sich ein Konto, ein Guthaben, dieselben Modelle und dieselben Preise. Sie können also mit einem beginnen und später einen weiteren dazunehmen.

Im Browser ausprobieren

• Geeignet für: alle, die sehen möchten, was ein Modell kann, bevor sie irgendetwas entscheiden. Nichts zu installieren, kein Code.
• Sie brauchen: einen Webbrowser. Jedes Modell können Sie ohne Konto öffnen und sein Formular ausfüllen. Um auf Ausführen zu klicken, müssen Sie angemeldet sein und Guthaben haben.
• Kostet das Geld? Jeder Lauf wird wie ein API-Aufruf abgerechnet. Bei fehlgeschlagenen oder abgelaufenen Tasks wird die Reservierung normalerweise vollständig freigegeben. Einige Inhaltsablehnungen werden zum angenommenen Angebotspreis berechnet, sofern die Modellseite diese Ausnahme ausdrücklich nennt. Prüfen Sie den endgültigen Betrag anhand von settled und cost.
• Los geht's: Öffnen Sie spicyapi.ai/explore, wählen Sie ein Modell und nutzen Sie auf seiner Seite den Tab Playground. Abgeschlossene Läufe erscheinen außerdem unter Logs in der Konsole.

Ihren KI-Assistenten fragen

• Geeignet für: alle, die bereits einen KI-Assistenten wie Claude, Cursor, VS Code, Codex, Windsurf oder Gemini CLI nutzen und im Chat Modelle durchsuchen, Preise vergleichen und Bilder oder Videos erzeugen möchten. Auch Entwickler nutzen diesen Weg, um sich vor dem Bauen einen Überblick zu verschaffen.
• Sie brauchen: Node.js 22.13 oder neuer, einen API-Schlüssel und eine Assistenten-App, die MCP unterstützt. Kostenpflichtige Schritte funktionieren nur in Apps, die Ihnen eine Bestätigungsfrage anzeigen können.
• Kostet das Geld? Durchsuchen, Kostenschätzungen und das Nachschlagen von Ergebnissen sind kostenlos. Bevor eine Generierung startet oder wiederholt wird, hält der Ablauf an und zeigt Ihnen den Preis; diese Frage kann der Assistent nicht für Sie beantworten.
• Los geht's: Der MCP-Server stellt dem Assistenten SpicyAPI-Aktionen zur Verfügung. Der Agent Skill bringt einem KI-Coding-Assistenten bei, SpicyAPI-Integrationen auf die sichere Art zu schreiben, und ergänzt den Server gut.

Befehle im Terminal eingeben

• Geeignet für: Preise vergleichen, Bilder und Videos auf dem eigenen Computer erzeugen und die Dateien speichern, dieselbe Art von Auftrag wiederholt ausführen oder ein einfaches Skript laufen lassen. Ohne Programmieren.
• Sie brauchen: ein Terminal, Node.js 22.13 oder neuer und einen API-Schlüssel in der Umgebungsvariable SPICY_API_KEY.
• Kostet das Geld? Nur spicyapi tasks create und spicyapi tasks retry können Kosten verursachen, und beide fragen nach, bevor etwas berechnet wird.
• Los geht's: Kommandozeilen-Tool (CLI).

Node-Workflows in ComfyUI bauen

• Geeignet für: alle, die schon in ComfyUI arbeiten und gehostete Modelle neben ihren lokalen Nodes nutzen möchten: ein Bildmodell mit einem Videomodell verketten, einen Soundtrack ergänzen oder ein Chatmodell den Prompt schreiben lassen.
• Sie brauchen: ComfyUI auf Ihrem Computer oder einem Server und einen API-Schlüssel. Die Modelle von SpicyAPI laufen auf unseren Servern, dafür ist also keine GPU nötig.
• Kostet das Geld? Jeder Lauf wird wie ein API-Aufruf abgerechnet. Jeder Node zeigt seinen Preis, nennt vor dem Lauf eine Kostenschätzung und kann jeden Lauf über einem von Ihnen gesetzten Limit stoppen.
• Los geht's: ComfyUI-Nodes.

Code schreiben

• Geeignet für: Bild-, Video- oder Textgenerierung in Ihre eigene App, das Backend Ihrer Website oder Ihre Datenpipeline einbauen.
• Sie brauchen: Code, der auf einem Server oder Ihrem eigenen Computer läuft, denn ein API-Schlüssel darf nie in eine Webseite oder eine mobile App gelangen. Offizielle SDKs gibt es für TypeScript (Node.js 22.13 oder neuer), Python 3.11+, Go 1.23+, PHP 8.1+ und Java 17+; jede andere Programmiersprache kann die HTTP-API direkt aufrufen.
• Kostet das Geld? Jede angenommene Generierung wird berechnet. Kostenschätzungen, Katalogabfragen und das Nachschlagen von Tasks sind kostenlos.
• Los geht's: das TypeScript-SDK für Node.js oder die SDKs für Python, Go, PHP und Java. Für reines HTTP mit Beispielen in curl, Node.js, Python und Go nehmen Sie den Schnellstart; für Chatmodelle siehe Text und Streaming und für ein vollständig durchgespieltes Beispiel das Bild-zu-Video-Tutorial.

Begriffe, die Ihnen überall begegnen

Für den Playground brauchen Sie nichts davon, alle anderen Seiten setzen es aber voraus. Jeder Begriff bekommt hier ein, zwei Sätze, einen Link zu der Seite mit den Details und einen ausführlicheren Eintrag in einfacher Sprache im Glossar.

Was passiert, wenn Sie etwas generieren

1. Sie wählen ein Modell und füllen seine Eingaben aus.
2. Optional fordern Sie eine Kostenschätzung an: den genauen Preis, kostenlos.
3. Sie senden ab. SpicyAPI nimmt die Anfrage als Task an, gibt Ihnen eine Task-ID und reserviert den geschätzten Betrag in Ihrem Guthaben.
4. Das Modell arbeitet im Hintergrund. Bilder dauern meist Sekunden, Videos oft Minuten.
5. Der Task ist beendet. War er erfolgreich, zahlen Sie das, was er tatsächlich verbraucht hat, und nie mehr als den reservierten Betrag. Bei fehlgeschlagenen oder abgelaufenen Tasks wird die Reservierung normalerweise vollständig freigegeben. Einige Inhaltsablehnungen werden zum angenommenen Angebotspreis berechnet, sofern die Modellseite diese Ausnahme ausdrücklich nennt. Prüfen Sie den endgültigen Betrag anhand von settled und cost.
6. Sie holen das Ergebnis ab, entweder weil SpicyAPI Ihren Server zurückruft oder weil Sie nachfragen, und laden die Datei herunter. Download-Links gelten nur eine begrenzte Zeit, und Dateien werden nur begrenzt lange aufbewahrt. Speichern Sie also, was Sie behalten möchten.

Modell-ID

Jedes Modell hat eine exakte ID der Form publisher/model/task. Kopieren Sie sie aus dem Live-Katalog (GET /api/v1/models, spicyapi models list oder listModels()) und nicht aus dem Gedächtnis oder von einer Webseite: Modelle kommen hinzu, werden pausiert und eingestellt. Die Codebeispiele in dieser Dokumentation schreiben MODEL_ID_FROM_CATALOG an die Stelle, an die eine echte ID gehört. Modellkatalog und Schemas · Glossar: Modell-ID

Tasks und ihr Status

Bild- und Videogenerierung läuft asynchron: Absenden und Abholen des Ergebnisses sind zwei getrennte Schritte, verbunden durch eine Task-ID, die mit job_ beginnt. Ein Task wechselt von queued zu running und endet als succeeded, failed oder expired; jeder Status außer queued oder running ist endgültig. Textmodelle antworten dagegen direkt über dieselbe Verbindung, oft Wort für Wort. Asynchrone Tasks · Text und Streaming · Glossar: Task-Status

Kostenschätzung

Eine Kostenschätzung berechnet den Preis genau Ihrer Anfrage, ohne etwas zu starten oder Geld zu reservieren. Sie gilt fünf Minuten. Senden Sie mit ihr ab und haben sich Preis oder Anfrage inzwischen geändert, wird die Übermittlung abgelehnt, statt einen anderen Betrag zu berechnen. Kostenschätzungen und Kompatibilität · Glossar: Kostenschätzung

Idempotenzschlüssel

Eine Kennung, die Sie selbst für einen bestimmten Arbeitsauftrag festlegen und mitsenden. Bricht Ihre Verbindung ab und Sie senden dieselbe Anfrage innerhalb von 24 Stunden mit derselben Kennung und demselben API-Schlüssel erneut, erhalten Sie den ursprünglichen Task zurück, statt einen zweiten zu starten und zu bezahlen. CLI und MCP-Server erzeugen diese Kennung für Sie; mit dem SDK oder reinem HTTP übergeben Sie Ihre eigene. Idempotenz · Glossar: Idempotenzschlüssel

Callbacks

Statt immer wieder zu fragen, ob ein Task fertig ist, können Sie ihm eine callBackUrl mitgeben: eine öffentliche HTTPS-Adresse auf Ihrem Server. Ist der Task fertig, schickt SpicyAPI das Ergebnis dorthin, signiert, damit Sie prüfen können, dass es wirklich von SpicyAPI stammt. Wiederholtes Nachfragen, Polling genannt, ist völlig in Ordnung, solange Sie auf Ihrem eigenen Computer testen. Webhooks · Glossar: Webhook

Wie lange Ergebnisse aufbewahrt werden

Der Download-Link eines Ergebnisses gilt etwa 20 Minuten; fragen Sie den Task erneut ab, um einen frischen zu erhalten. Erzeugte Dateien werden höchstens etwa 14 Tage aufbewahrt, hochgeladene Dateien einen Tag und Prompt-Texte 30 Tage. Alle drei Fristen können Sie verkürzen, und die Inhalte eines einzelnen Tasks können Sie auf Wunsch vernichten. Abrechnungsdaten werden deutlich länger aufbewahrt. Laden Sie alles herunter, was Sie behalten möchten. Datenaufbewahrung und Löschung · Glossar: Aufbewahrung

Guthaben und Ausgabenlimits

Ihr Guthaben besteht aus vorausbezahlten US-Dollar. Jeder API-Schlüssel kann außerdem ein Tages-, Monats- und Gesamtlimit für Ausgaben haben, das Sie selbst festlegen. Reicht Ihr Guthaben für einen Task nicht aus, erhalten Sie den Fehler 40201; ist ein Limit erreicht, erhalten Sie 40202. In beiden Fällen entsteht kein Task, und es wird nichts berechnet. Abrechnung · Authentifizierung · Glossar: Ausgabenlimit

Ihr erster Durchlauf, Schritt für Schritt

Wo Sie Hilfe bekommen

• Schnelle Antworten: FAQ, Glossar, Fehlerdiagnose und Wiederherstellung und Fehler.
• Läuft der Dienst? status.spicyapi.ai.
• Mit uns sprechen: Starten Sie eine Unterhaltung auf der Seite Support in der Konsole oder nutzen Sie die Kontaktseite. Nennen Sie die request_id oder die Task-ID und die Uhrzeit in UTC. Senden Sie niemals Ihren API-Schlüssel.

Weiter