Przejdź do treści głównej

Wiersz poleceń

Generuj obrazy i wideo prosto z terminala

Polecenie spicyapi pozwala przeglądać modele, sprawdzić dokładną cenę, uruchomić generowanie i pobrać wynik bez pisania kodu. Polecenia płatne zawsze się zatrzymują i pytają o zgodę.

Utwórz klucz APIPełny przewodnik w dokumentacji

Do czego służy CLI

To najszybszy sposób na wypróbowanie modelu: wpisz polecenie, zobacz dokładną cenę, potwierdź i odbierz plik. Bez projektu, bez kodu.

  1. Wpisujesz polecenieTerminal lub PowerShell
  2. spicyapiPokazuje dokładną cenę i pyta o zgodę
  3. Twój wynikLink do pobrania albo JSON dla skryptów
Przeglądanie, wycena i pobieranie są bezpłatne. Pieniądze kosztuje tylko utworzenie lub ponowienie zadania.

Do czego się nadaje

  • Szybkie próby modeliPorównaj modele i ceny, zanim ktokolwiek napisze kod.
  • Skrypty powłokiPrzekieruj wynik --json do jq, zaplanowanych zadań lub kroków CI.
  • Agenci programistyczniAgenci mogą uruchamiać polecenia i czytać wynik w JSON-ie.

Skonfiguruj w dwie minuty

  1. Krok 1

    Zainstaluj Node.js 22.13 lub nowszy

    Uruchom node -v. Jeśli wyświetli starszą wersję, zainstaluj wersję LTS z nodejs.org i otwórz terminal ponownie.

    terminal
    node -v
  2. Krok 2

    Wpisz klucz do SPICY_API_KEY

    CLI czyta klucz wyłącznie ze środowiska. Nigdy nie przyjmuje go jako argumentu ani go nie wyświetla, więc nie wycieknie przez historię powłoki.

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

    Uruchom przez npx albo zainstaluj raz

    npx uruchamia najnowszą wersję bez instalowania czegokolwiek. Zainstaluj globalnie, jeśli używasz CLI codziennie.

    npx @spicyapi/cli status

Pierwszy obraz z terminala

Znajdź model, który możesz wywołać, sprawdź dokładną cenę, a potem utwórz zadanie i poczekaj na wynik. Zapisz dane wejściowe w pliku, żeby uniknąć problemów z cudzysłowami w powłoce.

  1. Krok 1

    Znajdź model

    Wyświetl modele obrazu, które możesz wywołać, wraz z cenami.

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

    Sprawdź cenę

    Zapisz prompt w pliku i poznaj dokładny koszt. Nic nie jest pobierane.

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

    Utwórz i poczekaj

    CLI pokazuje cenę, pyta o Twoją zgodę, a potem czeka na wynik.

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

    Pobierz

    Zapisz plik z linku do wyniku, zanim wygaśnie.

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

Co możesz zrobić

Pieniądze wydają tylko dwa polecenia i oba pokazują cenę oraz czekają na Twoje potwierdzenie.

  1. Przeglądanie

    01
    • spicyapi status

      Sprawdź, czy SpicyAPI jest osiągalne

      Bezpłatne
    • spicyapi models list

      Wyświetl dostępne modele wraz z cenami

      Bezpłatne
    • spicyapi models get <model>

      Pokaż dokładne ustawienia, które przyjmuje model

      Bezpłatne
    • spicyapi balance

      Sprawdź swoje saldo

      Bezpłatne

  2. Cena

    02
    • spicyapi tasks quote

      Poznaj dokładną cenę przed startem

      Bezpłatne

  3. Generowanie

    03
    • spicyapi tasks create

      Uruchom generowanie obrazu lub wideo

      Pyta o zgodę przed pobraniem opłaty
    • spicyapi tasks wait <task-id>

      Poczekaj na zakończenie generowania

      Bezpłatne
    • spicyapi tasks get <task-id>

      Pokaż generowanie i linki do wyniku

      Bezpłatne

  4. Pliki

    04
    • spicyapi files upload <path>

      Prześlij obraz, wideo lub plik audio jako dane wejściowe

      Bezpłatne
    • spicyapi files download-url <task-id>

      Pobierz nowy link do pobrania wyniku

      Bezpłatne

Stworzone także dla skryptów i agentów AI

Dodaj --json do dowolnego polecenia, aby dostać pełny wynik w JSON-ie; błędy trafiają na stderr jako jedna linia JSON, a przy porażce kod wyjścia jest niezerowy. Agenci programistyczni mogą uruchamiać CLI bezpośrednio albo użyć serwera MCP dla pełniejszej integracji.

MCP i agenciOtwórz pakietZobacz kod źródłowy
--json
spicyapi --json tasks get <task-id> > task.json

Typowe błędy i poprawki

Pierwsze problemy zwykle sprowadzają się do tych trzech sytuacji. Każda karta opisuje objaw i jedną zmianę, która go rozwiązuje.

  • $

    command not found: spicyapi

    Globalna instalacja nie jest w Twoim PATH. Uruchom zamiast tego npx @spicyapi/cli albo zainstaluj ponownie przez npm install -g @spicyapi/cli.

  • klucz

    Brak ustawionego klucza

    SPICY_API_KEY działa tylko w oknie, w którym go ustawiono. Ustaw go ponownie albo dodaj do profilu powłoki.

  • node

    Node.js jest za stary

    CLI wymaga Node.js 22.13 lub nowszego. Sprawdź przez node -v i zainstaluj aktualną wersję LTS.

Najczęstsze pytania