Zum Hauptinhalt springen

Kommandozeile

Bilder und Videos aus dem Terminal erzeugen

Mit dem Befehl spicyapi stöbern Sie in Modellen, prüfen einen exakten Preis, starten eine Generierung und laden das Ergebnis herunter – ganz ohne Code. Kostenpflichtige Befehle halten immer erst an und fragen nach.

API-Schlüssel anlegenVollständige Anleitung in der Doku

Wofür die CLI da ist

Der schnellste Weg, ein Modell auszuprobieren: Befehl eintippen, den exakten Preis sehen, bestätigen, Datei erhalten. Kein Projekt, kein Code.

  1. Sie tippen einen BefehlTerminal oder PowerShell
  2. spicyapiZeigt den exakten Preis und fragt vorher nach
  3. Ihr ErgebnisEin Download-Link oder JSON für Skripte
Stöbern, Preisabfragen und Downloads sind kostenlos. Nur das Erstellen oder Wiederholen eines Tasks kostet Geld.

Ideal für

  • Modelle schnell testenModelle und Preise vergleichen, bevor jemand Code schreibt.
  • Shell-Skripte--json-Ausgabe an jq, geplante Jobs oder CI-Schritte weiterleiten.
  • Coding-AgentenAgenten können Befehle ausführen und das JSON-Ergebnis lesen.

In zwei Minuten eingerichtet

  1. Schritt 1

    Node.js 22.13 oder neuer installieren

    Führen Sie node -v aus. Zeigt es eine ältere Version, installieren Sie das LTS-Release von nodejs.org und öffnen Sie das Terminal neu.

    terminal
    node -v
  2. Schritt 2

    Schlüssel in SPICY_API_KEY ablegen

    Die CLI liest den Schlüssel nur aus der Umgebung. Er wird nie als Argument akzeptiert und nie ausgegeben, kann also nicht über Ihren Shell-Verlauf abfließen.

    export SPICY_API_KEY="sk-spicy-..."   # paste your own key
  3. Schritt 3

    Mit npx starten oder einmal installieren

    npx führt die jeweils neueste Version aus, ohne etwas zu installieren. Installieren Sie global, wenn Sie die CLI täglich nutzen.

    npx @spicyapi/cli status

Ihr erstes Bild aus dem Terminal

Suchen Sie ein aufrufbares Modell, prüfen Sie den genauen Preis, erstellen Sie den Task und warten Sie auf das Ergebnis. Legen Sie die Eingabe in eine Datei, um Probleme mit Anführungszeichen in der Shell zu vermeiden.

  1. Schritt 1

    Modell finden

    Listet die aufrufbaren Bildmodelle mit ihren Preisen auf.

    models list
    spicyapi models list --modality image --json
  2. Schritt 2

    Preis prüfen

    Legen Sie den Prompt in eine Datei und holen Sie die exakten Kosten. Es wird nichts abgebucht.

    tasks quote
    echo '{ "prompt": "A cinematic night portrait" }' > input.json
spicyapi tasks quote --model MODEL_ID_FROM_CATALOG --input-file input.json
  3. Schritt 3

    Erstellen und warten

    Die CLI zeigt den Preis, wartet auf Ihr Ja und dann auf das Ergebnis.

    tasks create
    spicyapi tasks create \
  --model MODEL_ID_FROM_CATALOG \
  --input-file input.json \
  --wait
  4. Schritt 4

    Herunterladen

    Speichern Sie die Datei vom Ergebnislink, bevor er abläuft.

    download
    curl -L -o result.png "PASTE_THE_URL_HERE"

Was Sie damit tun können

Nur zwei Befehle kosten Geld, und beide zeigen den Preis und warten auf Ihr Ja.

  1. Entdecken

    01
    • spicyapi status

      Prüfen, ob SpicyAPI erreichbar ist

      Kostenlos
    • spicyapi models list

      Nutzbare Modelle mit Preisen auflisten

      Kostenlos
    • spicyapi models get <model>

      Die genauen Einstellungen eines Modells anzeigen

      Kostenlos
    • spicyapi balance

      Guthaben prüfen

      Kostenlos

  2. Preis

    02
    • spicyapi tasks quote

      Den exakten Preis vor dem Start abrufen

      Kostenlos

  3. Erzeugen

    03
    • spicyapi tasks create

      Eine Bild- oder Videogenerierung starten

      Fragt vor der Abbuchung nach
    • spicyapi tasks wait <task-id>

      Auf das Ende einer Generierung warten

      Kostenlos
    • spicyapi tasks get <task-id>

      Eine Generierung samt Ergebnislinks anzeigen

      Kostenlos

  4. Dateien

    04
    • spicyapi files upload <path>

      Bild, Video oder Audiodatei als Eingabe hochladen

      Kostenlos
    • spicyapi files download-url <task-id>

      Einen frischen Download-Link für ein Ergebnis holen

      Kostenlos

Auch für Skripte und KI-Agenten gebaut

Mit --json liefert jeder Befehl das vollständige Ergebnis als JSON; Fehler erscheinen als eine JSON-Zeile auf stderr, bei Misserfolg endet der Befehl mit einem Exit-Status ungleich null. Coding-Agenten können die CLI direkt ausführen oder für eine tiefere Anbindung den MCP-Server nutzen.

MCP & AgentenPaket öffnenQuellcode ansehen
--json
spicyapi --json tasks get <task-id> > task.json

Häufige Fehler beheben

Die meisten Anfangsprobleme sind eines dieser drei. Jede Karte zeigt, was Sie sehen und was Sie ändern müssen.

  • $

    command not found: spicyapi

    Die globale Installation liegt nicht in Ihrem PATH. Führen Sie stattdessen npx @spicyapi/cli aus oder installieren Sie neu mit npm install -g @spicyapi/cli.

  • Schlüssel

    Schlüssel nicht gesetzt

    SPICY_API_KEY gilt nur für das Fenster, in dem Sie ihn gesetzt haben. Setzen Sie ihn erneut oder tragen Sie ihn in Ihr Shell-Profil ein.

  • node

    Node.js ist zu alt

    Die CLI braucht Node.js 22.13 oder neuer. Prüfen Sie mit node -v und installieren Sie das aktuelle LTS-Release.

Häufige Fragen