Przygotuj konto

Załóż konto i zweryfikuj adres e-mail

Otwórz spicyapi.ai/register. Konto można założyć na trzy sposoby:

Zaznacz zgodę na Regulamin i Politykę prywatności, a potem wybierz Załóż konto.

Co zobaczysz: przy koncie na e-mail – stronę z tytułem Sprawdź skrzynkę. Otwórz wiadomość i kliknij link. Strona Adres e-mail zweryfikowany potwierdza weryfikację, a przycisk Przejdź do konsoli zabiera cię do środka.

Co się właśnie stało: konto już istnieje, ale wywoływać API może dopiero po weryfikacji adresu e-mail. Do tego czasu konsola pokazuje baner Adres e-mail niezweryfikowany – wywołania API są zablokowane.

• Link działa jeden raz i wygasa po 24 godzinach. Jeśli wygasł, i tak go otwórz i użyj opcji Wyślij nowy link weryfikacyjny albo wybierz Zweryfikuj na banerze w konsoli.
• Po kilku minutach nic nie przyszło? Sprawdź folder spam, a potem użyj Wyślij ponownie.

Doładuj konto

Otwórz w konsoli Rozliczenia: spicyapi.ai/console/billing. W sekcji Doładuj konto:

1. Wybierz kwotę. Kliknij jedną z gotowych kwot (na przykład $10, $25, $50 albo $100) albo Własna i wpisz własną. Konsola pokazuje najmniejszą i największą kwotę, jaką można dodać jedną płatnością. Płatności online przyjmują najwyżej dwa miejsca po przecinku.
2. Sprawdź, czy jest bonus. Przy niektórych kwotach przysługuje bonus promocyjny, widoczny przed zapłatą jako +$… bonusu. Bonus jest dopisywany jako osobny wpis obok kwoty, którą wpłacasz.
3. Wybierz sposób płatności i postępuj według odpowiedniej karty poniżej.

Inne komunikaty, które możesz zobaczyć:

• Doładowanie jest niedostępne albo W tej chwili nie można utworzyć zlecenia doładowania: doładowania są chwilowo wyłączone albo masz zbyt wiele oczekujących zleceń. Dokończ albo anuluj stare zlecenia w sekcji Zlecenia doładowania albo spróbuj później.
• Połączenie zostało przerwane, więc wynik jest nieznany: zanim spróbujesz ponownie, sprawdź Zlecenia doładowania, żeby nie zapłacić dwa razy.

Opcjonalnie: włącz automatyczne doładowanie

Automatyczne doładowanie obciąża zapisaną kartę za ciebie, gdy saldo się kończy, dzięki czemu długie prace nie zatrzymują się w połowie z kodem 40201. Działa tylko z kartą.

1. W Rozliczeniach znajdź Automatyczne doładowanie i wybierz Zapisz metodę płatności bezpiecznie.
2. Na bezpiecznej stronie, która się otworzy, podaj dane karty. Dane karty zostają u operatora płatności.
3. Po powrocie do Rozliczeń zobaczysz Sprawdzamy Twoją metodę płatności, a potem Metoda płatności zapisana. Jeśli zobaczysz Tej karty nie da się tu użyć, nic nie zostało zapisane; spróbuj innej karty.
4. Wypełnij trzy pola:
   • Doładuj poniżej: saldo, przy którym następuje obciążenie.
   • Kwota jednego doładowania: ile dodaje każde obciążenie. Musi mieścić się w tym samym zakresie co zwykłe doładowanie.
   • Limit miesięczny: najwyższa kwota, jaką automatyczne doładowanie może pobrać w jednym miesiącu kalendarzowym. Nie może być niższy niż kwota jednego doładowania.
5. Zaznacz zgodę na obciążanie i wybierz Włącz automatyczne doładowanie.

Co zobaczysz: Automatyczne doładowanie jest już włączone, z tymi limitami. Karta pokazuje regułę, na przykład „Doładowuje $50, gdy saldo spadnie poniżej $10”, oraz pozycję Wykorzystano w tym miesiącu.

Dokładne zasady:

• Saldo sprawdzamy mniej więcej co 30 sekund do 2 minut. Gdy dostępne saldo jest równe progowi albo niższe, obciążamy zapisaną kartę ustawioną kwotą.
• Każde obciążenie to zwykłe zlecenie doładowania z oznaczeniem Automatyczne. Dostaje taki sam bonus jak ręczne doładowanie tej samej kwoty i możesz wystawić do niego fakturę.
• Limit miesięczny liczy miesiące kalendarzowe w UTC. Gdy zostanie wykorzystany, automatyczne doładowanie czeka do 1. dnia następnego miesiąca. Nieudane obciążenia nie wliczają się do limitu.
• Jeśli obciążenie się nie powiedzie, próbujemy ponownie po 1 godzinie i jeszcze raz po 6 godzinach. Jeśli także trzecia próba z rzędu się nie powiedzie, automatyczne doładowanie samo się wyłącza. Jeśli bank wprost odrzuci kartę (na przykład skradzioną albo zamkniętą), wyłącza się natychmiast. Udane obciążenie zeruje licznik.
• Gdy automatyczne doładowanie samo się wyłączy, napraw kartę (albo zapisz nową) i włącz je ponownie.
• Wyłącz automatyczne doładowanie w każdej chwili zatrzymuje przyszłe obciążenia. Nigdy nie zmienia salda ani doładowań, które już zostały zrealizowane.

Utwórz klucz API

Otwórz Klucze API: spicyapi.ai/console/keys i wybierz Utwórz klucz (albo Utwórz pierwszy klucz).

W oknie Utwórz klucz API wymagana jest tylko nazwa. Wszystko w sekcji Zaawansowane można zmienić później.

Nazwa. Nazwij klucz po tym, co będzie go używać, na przykład production backend albo my laptop. Nazwa pomoże ci go rozpoznać, gdy trzeba będzie go unieważnić. Do 120 znaków.

Limity wydatków (w sekcji Zaawansowane, w dolarach amerykańskich). Po osiągnięciu limitu ten klucz odrzuca nowe zadania z kodem 40202, dopóki nie zacznie się kolejny okres. Pozostałe klucze działają dalej. Środki zablokowane na zadania, które jeszcze trwają, wliczają się do każdego limitu.

Wpisz 0 w dowolnym limicie, żeby nie ustawiać limitu; puste pole oznacza to samo.

Dostęp.

• Dozwolone modele. Zostaw Wszystkie modele (bez ograniczeń), a klucz będzie mógł wywoływać każdy model, także dodany później. Wybierz konkretne modele, a klucz odrzuci każdy inny model z kodem 40301.
• Lista dozwolonych IP. Dowolny adres przyjmuje wywołania z każdego miejsca. Tylko te przyjmuje wywołania wyłącznie z adresów, które podasz: IPv4, IPv6 albo zakresy CIDR, takie jak 203.0.113.10, 198.51.100.0/24, oddzielone przecinkami, najwyżej 64 pozycje. Podaj publiczny adres, z którego łączy się twój serwer, a nie adres z wnętrza sieci w biurze czy w domu. Wywołania z innych adresów są odrzucane z kodem 40302. W przypadku laptopa, którego adres się zmienia, zostaw Dowolny adres.
• Wygaśnięcie. Wybierz 7, 30 albo 90 dni, 1 rok, Nigdy albo dokładną datę. Klucz przestaje działać z końcem tego dnia, czasu UTC, a od tej chwili dostaje ten sam kod 401 co klucz unieważniony.

Wybierz Utwórz klucz.

Co zobaczysz: okno Klucz utworzony z pełnym kluczem, który zaczyna się od sk-spicy-. Skopiuj go przyciskiem Kopiuj klucz albo wybierz Zapisz jako plik. Zaznacz Klucz jest zapisany w bezpiecznym miejscu, a potem wybierz Gotowe.

Co się właśnie stało: to jedyny moment, w którym widać pełny klucz. Przechowujemy tylko jego jednokierunkowy skrót, więc nikt, także nasz zespół wsparcia, nie może pokazać ci go ponownie. Jeśli go zgubisz, unieważnij go i utwórz nowy.

Później, na tej samej stronie:

• Edytuj zmienia nazwę, limity, dozwolone modele, listę dozwolonych IP i datę wygaśnięcia. Zmiany działają od razu.
• Unieważnij natychmiast wyłącza klucz i nie da się tego cofnąć. Zadania, które zostały już przyjęte, działają dalej i nadal są płatne.
• W jednym zakresie możesz mieć do 50 aktywnych kluczy. Używaj jednego klucza na aplikację albo środowisko, żeby móc unieważnić jeden bez zatrzymywania pozostałych.

Zapisz klucz w SPICY_API_KEY

Zmienna środowiskowa to nazwana wartość, którą terminal przekazuje uruchamianym przez siebie programom. Oficjalne SDK, CLI i serwer MCP, a także wszystkie przykłady w tej dokumentacji, odczytują klucz ze zmiennej o nazwie SPICY_API_KEY. Dzięki temu klucza nigdy nie trzeba wpisywać w poleceniu ani zapisywać w projekcie.

Najpierw otwórz terminal: w macOS naciśnij Cmd + Spacja, wpisz Terminal i naciśnij Enter. W Windows otwórz menu Start, wpisz PowerShell i otwórz Windows PowerShell.

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

nano ~/.zshrc

echo "${SPICY_API_KEY:0:9}"

Na serwerze ustaw SPICY_API_KEY w ustawieniach sekretów albo zmiennych środowiskowych u swojego dostawcy hostingu, a nie w pliku w projekcie.

Wykonaj bezpłatne wywołanie testowe

To wywołanie pyta o saldo. Nic nie kosztuje, niczego nie tworzy i sprawdza naraz trzy rzeczy: klucz jest ustawiony, klucz jest prawidłowy, a twoje konto może wywoływać API.

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

Oczekiwany wynik: odpowiedź podobna do tej (skróconej):

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

Co to znaczy: "code": 200 oznacza powodzenie. Kwoty są w dolarach amerykańskich, zapisane jako tekst. available to kwota, którą możesz wydać na nowe generacje, held jest zablokowane na generacje, które jeszcze trwają, a total to obie te kwoty razem. Prawdziwa odpowiedź zawiera też obiekt funding, który oddziela wpłacone środki od ewentualnych przyznanych środków promocyjnych; na razie możesz go pominąć.

Jeśli dostajesz coś innego:

Wolisz nie używać curl? CLI robi to samo poleceniem spicyapi balance.