Updates, die für Ihre Integration zählen

Vier neue Orte, an denen Sie entscheiden können, welches Modell Sie nutzen – alle aufgebaut aus Läufen auf dieser Plattform. Ranglisten, Reviews und die Blind-Arena finden Sie im Seitenkopf unter Rankings, die Prompt-Bibliothek unter Studio.

• Ranglisten bewerten jedes Modell auf zwei getrennten Skalen. Der Spicy Index (0–100) ist vorerst vorläufig und bewertet nur die Leistungsfähigkeit; die Ausgabequalität kommt hinzu, sobald unsere Qualitätstests und genügend Arena-Stimmen vorliegen. Der Freedom Score (0–100) misst, wie weit ein Modell auf unserer Stufenleiter für Inhaltstests nachweislich geht. Beide werden nie vermischt; Preis, Tempo und Zuverlässigkeit stehen als Rohmesswerte daneben. Es gibt Ranglisten für Video, Bild, LLM, unzensiert, Preis-Leistung und Tempo; Stand 26. September sind 53 Modelle aus 1.672 Testläufen gerankt, und die Werte werden täglich neu berechnet.
• Reviews: bisher acht – MiniMax H3, MiniMax H3 Spicy, Seedance 2.5, Seedance 2.5 Spicy, Wan 3.0, Seedream 5.0 Pro, Z-Image Spicy und Grok 4.7. Jedes zeigt echte Ausgaben, einen Testbericht, was ein brauchbares Ergebnis kostet, und eine klare Empfehlung.
• Blind-Arena: zwei anonyme Bild- oder Videoergebnisse aus einem Prompt. Wählen Sie das, das Sie behalten würden, und sehen Sie dann, welche Modelle sie erzeugt haben. Stimmen angemeldeter Nutzer ergeben Bradley-Terry-Ratings mit 95-%-Intervallen, stündlich aktualisiert; Modelle mit überlappenden Intervallen teilen sich einen Rang. Ränge erscheinen erst, wenn genügend Stimmen angemeldeter Nutzer vorliegen; bis dahin sind die Modelle nach Hersteller aufgelistet.
• Prompt-Bibliothek: 176 Prompts für Video- und Bildmodelle, jeweils mit dem Ergebnis, das sie tatsächlich erzeugt haben. Filtern Sie nach Modell, Aufgabe, Szene oder Kamerabewegung, und kopieren Sie den Prompt oder öffnen Sie ihn mit allen Einstellungen im Playground.

Die Methodik ist öffentlich und versioniert. Wir verkaufen Zugang zu jedem Modell, das wir ranken; die Methodikseite erklärt deshalb auch, wie das aus den Werten herausgehalten wird.

Vier Änderungen daran, wie sich Tasks verhalten. Zwei davon können eine Anpassung auf Ihrer Seite erfordern: Wenn Sie sich darauf verlassen, dass identische Anfragen identische Ergebnisse liefern, senden Sie einen seed mit; wenn Sie auf Fehlercodes verzweigen, behandeln Sie 40310.

Ein fehlgeschlagener Lauf wird zuerst über eine andere Route wiederholt. Viele Modelle hier laufen über mehr als eine Route. Seit dem 23. September gilt: Scheitert ein Lauf, nachdem wir ihn angenommen haben, und bedient eine andere Route dasselbe Modell mit denselben Einstellungen, führen wir ihn dort aus, bevor wir einen Fehler melden – solange die Task noch Zeit hat. Berechnet wird einmal, für das Ergebnis, das Sie erhalten. Fehler, die sich überall wiederholen würden, etwa eine Ablehnung wegen Urheberrechts, werden nicht wiederholt.

Ablehnungen nennen Ursache und Abhilfe. Blockiert ein Modell ein Ergebnis wegen möglicher Urheberrechtsverletzung oder des Gesichts einer realen Person, sagt errorMessage jetzt, was davon zutraf und was Sie versuchen können:

• Bei Video ist der Auslöser meist die generierte Tonspur: Setzen Sie generate_audio: false, entfernen Sie Referenzaudio und nennen Sie keine realen Songs oder Künstler im Prompt.
• Bei Bildern steckt meist eine bekannte Figur, ein Logo oder ein Kunstwerk im Prompt oder in einem Referenzbild.
• Manche Modelle akzeptieren keine Gesichter realer Personen in Referenzbildern. Die Meldung sagt das und schlägt ein anderes Modell oder eine gezeichnete Figur vor.

errorCode bleibt content_rejected, der Betrag wird erstattet, und die Meldung folgt wie jede andere Fehlermeldung Ihrer API-Fehlersprache.

Ein zufälliger Seed, wenn Sie seed weglassen. Seit dem 24. September erhält eine Anfrage ohne Seed bei Modellen, die seed annehmen, einen zufälligen Seed, der im input der Task zurückkommt. Zwei identische Anfragen liefern also nicht mehr dasselbe Ergebnis. Damit Läufe vergleichbar bleiben, schicken Sie den zurückgegebenen Seed erneut mit; ein fester Seed garantiert allerdings kein identisches Ergebnis. Einige wenige Modelle variieren den Seed, ohne ihn zurückzugeben. Ein Seed, den Sie selbst senden, wird immer unverändert verwendet.

40310 für Konten mit unbestätigter E-Mail-Adresse. Schlüssel solcher Konten bekamen bisher ein allgemeines 403. Seit dem 25. September erhalten sie den Geschäftscode 40310 mit dem Hinweis, den Bestätigungslink zu öffnen oder in der Konsole einen neuen anzufordern. Der Schlüssel funktioniert, sobald die Adresse bestätigt ist.

Fünf offizielle SDKs sind da, dazu eine CLI, ein MCP-Server, ein Agent Skill und ein Proxy, der ohne Schlüssel im Client auskommt. Alle setzen dieselben vier Schritte um: Preis nennen, mit Idempotenzschlüssel anlegen, warten, abholen.

• In Ihren Abhängigkeitsbaum kommt fast nichts. Python und Go nutzen nur die Standardbibliothek, PHP braucht ebenfalls keine Bibliothek, und Java bringt genau eine mit: Jackson.
• Der gesamte asynchrone Ablauf, nicht nur der HTTP-Aufruf — ein Wartebudget beim Anlegen der Aufgabe, der dreistufige Upload für eigene Bilder und Videos und die Verifikation der Webhook-Signatur.
• @spicyapi/cli durchsucht den Katalog, nennt den Preis vor der Ausgabe und lädt fertige Ergebnisse im Terminal herunter. @spicyapi/mcp gibt Claude Code, Codex, Cursor oder jedem MCP-Client dieselben Fähigkeiten und fragt vor jedem kostenpflichtigen Schritt nach. Der Agent Skill wird mit npx skills add Spicy-API/spicy-skill installiert und bringt einem Coding-Assistenten die richtige Reihenfolge bei.
• @spicyapi/proxy hält den Schlüssel auf Ihrem Server. Ein Schlüssel in einer Browser-, Mobil- oder Desktop-App ist ein öffentlicher Schlüssel; dieses Paket ist der serverseitige Zwischenschritt, der ihn stattdessen verwahrt.

Alle fünf sind quelloffen unter MIT-Lizenz. Die Anleitungen: docs.spicyapi.ai

Zwei Wege, keine Polling-Schleife mehr zu schreiben. Beide sind verfügbar.

Ein Wartebudget beim Anlegen der Aufgabe. Hängen Sie ?wait=<Sekunden> an createTask, und wir halten die Verbindung offen, bis die Aufgabe einen Endzustand erreicht — die Antwort ist der vollständige Datensatz, in derselben Form wie bei recordInfo.

• Budget aufgebraucht: Sie erhalten das gewöhnliche 202, genau wie ohne den Parameter, und fragen ab da selbst ab.
• Verbindung abgebrochen: Für die Aufgabe ändert sich nichts. Sie läuft weiter und wird wie üblich abgerechnet.
• Die Obergrenze liegt bei 60 Sekunden. Größere Werte werden gekappt statt abgelehnt, ein fehlerhafter Wert wird ignoriert statt abgelehnt — ein Tippfehler in einem Optimierungsparameter darf keine Generierung scheitern lassen, die sonst gelungen wäre.

Sinnvoll bei Endpunkten, die in Sekunden fertig sind, also bei den meisten Bild- und Bearbeitungsaufträgen. Videomodelle laufen regelmäßig minutenlang; dort läuft das Budget schlicht ab und Sie fragen am Ende doch ab.

Webhook-Endpunkte auf Kontoebene. Registrieren Sie eine URL einmal zusammen mit den gewünschten Ereignissen, und jede passende Aufgabe wird dorthin zugestellt — eine Callback-URL pro Aufgabe entfällt. Ein Konto trägt bis zu 16 Endpunkte, jeder mit eigenem Signaturgeheimnis. Antwortet Ihr Server mit 410 Gone, wird der Endpunkt sofort deaktiviert, statt eine Adresse weiter anzurufen, die ihr Betreiber stillgelegt hat. Endpunkte gibt es vorerst nur über die API; im Kontrollzentrum existiert dafür noch keine Seite.

Mehr dazu: Aufgaben · Webhooks

403 Beispielläufe decken inzwischen 117 der 120 aufrufbaren Endpunkte ab. Jeder davon ist ein Auftrag, der tatsächlich auf dieser Plattform gelaufen ist — kein Konzeptbild, kein aus einer Modellkarte übernommenes Standbild. Zu jedem gehören drei Dinge:

• Die fertige Datei, aus unserem eigenen CDN, im ursprünglichen Seitenverhältnis.
• Das vollständige Eingabeobjekt, das sie erzeugt hat — Prompt, Größe, Dauer, jeder Parameter —, direkt zum Kopieren in Ihren eigenen Aufruf.
• Eine Erläuterung in allen zehn Oberflächensprachen: warum diese Eingabe gewählt wurde, für welches Seitenverhältnis die Komposition geschrieben ist, welcher Parameter die Arbeit tut und was man zuerst ändern sollte.

Auf jeder Modellseite stehen sie als überblickbare Wand von Ergebnissen; über die API kommen sie unter examples aus GET /console/v1/catalog/models/{slug}.

Ein Modell auszuwählen hieß bisher, eine Parametertabelle zu lesen und sich das Ergebnis vorzustellen. Jetzt sehen Sie, was ein Endpunkt wirklich produziert, und beginnen mit einer Eingabe, von der bekannt ist, dass sie dort funktioniert.

Katalog ansehen