Przejdź do treści głównej

Integracje

Podłącz modele obrazu, wideo i wybrane modele językowe przez jedno spójne API.

Do czatu i odgrywania ról używaj wywołań zgodnych z OpenAI, a do obrazów, wideo i audio — API zadań. Wybierz model, przechowuj klucz na serwerze i przejdź do ścieżki odpowiedniej dla wyniku.

Wybierz swoją drogę

Jeden klucz API, cztery sposoby połączenia

Zacznij tam, gdzie już pracujesz. Każda droga prowadzi do tych samych modeli w tych samych cenach.

Szybki start w 5 minut

Pierwszy obraz w czterech krokach

Utwórz zadanie, zapisz jego ID i odbierz gotowy plik. Ten sam schemat działa dla każdego modelu obrazu, wideo i dźwięku.

  1. 01

    Wybierz model

    Porównaj dopasowanie do zadania, przyjmowane wejścia, zasady dotyczące treści, bieżącą dostępność i cenę.

  2. 02

    Skopiuj działające żądanie

    Zastąp przykładowy identyfikator modelu i dane wejściowe dokładnymi polami podanymi na stronie wybranego modelu. Nie zgaduj parametrów na podstawie innego modelu.

  3. 03

    Wyślij z własnego serwera

    HTTP 202 oznacza, że zadanie zostało przyjęte, a nie że generowanie się zakończyło; kod aplikacyjny w odpowiedzi to nadal code: 200. Od razu zapisz data.taskId; estimatedCost to kwota zarezerwowana na to zadanie.

  4. 04

    Odpytuj o status z ograniczoną liczbą prób

    queued i running są wciąż w toku; succeeded, failed i expired są końcowe. Przerwij odpytywanie przy każdym stanie końcowym, zamiast czekać wyłącznie na powodzenie.

curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
  -H "Authorization: Bearer $SPICY_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: order-8814-render-1" \
  -d '{
    "model": "alibaba/z-image-turbo/text-to-image",
    "input": { "prompt": "A ceramic teapot on a linen cloth, soft window light" }
  }'

alibaba/z-image-turbo/text-to-image to rzeczywisty endpoint tekst–obraz. Dla innego modelu multimedialnego użyj jego dokładnego ID i schematu.

Katalog

Wszystkie integracje w jednym miejscu

Wybierz narzędzie, którego już używasz. Każda karta otwiera jego przewodnik konfiguracji.

Bezpieczeństwo serwera

Trzy rzeczy, które musi obsługiwać wdrożona aplikacja

Te trzy zasady dotyczą wycieku klucza, podwójnego naliczenia opłaty i utraty zadania. To minimum przed uruchomieniem aplikacji dla użytkowników.

Trzymaj klucz API na serwerze

Nigdy nie ujawniaj klucza SpicyAPI w kodzie przeglądarki, w paczce aplikacji mobilnej, w promptach, logach ani w wyniku widocznym dla agenta. Wysyłaj żądania z backendu, który sam kontrolujesz.

Idempotency-Key

Przy każdym żądaniu tworzenia zadania wysyłaj stabilny Idempotency-Key. Gdy nie masz pewności, czy żądanie dotarło, ponów tę samą operację z tym samym kluczem, aby nie utworzyć dwóch płatnych zadań.

Śledź przyjęte zadania multimedialne

Zapisz zwrócone taskId i użyj podpisanego webhooka albo ograniczonego odpytywania statusu. Przyjęte zadanie rusza i nie da się go anulować. Nieudane zadania i zadania po upływie limitu czasu zwykle nie są płatne. Niektóre modele pobierają opłatę za odmowę wygenerowania treści zgodnie z opisem na stronie modelu; sprawdź te zasady przed wysłaniem.

Dokumentacja API

Znajdź dokumentację odpowiadającą na Twoje pytanie