Face Swap Pro API

Przenosi rysy twarzy z jednego obrazu na osobę na innym. Przenoszą się tylko rysy: fryzura, linia włosów, sylwetka głowy, poza, strój, światło i tło obrazu docelowego zostają bez zmian. Właśnie dlatego wynik osadza się w oryginalnym zdjęciu, a nie leży na nim jak naklejka.

Face Swap Pro to precyzyjny poziom linii Face Swap. Silnik sam znajduje punkty kluczowe twarzy na obu zdjęciach i nakłada jeden zestaw na drugi, a potem nic już nie jest nakładane na wynik. Całe żądanie to dwa URL-e obrazów — image_url dla zdjęcia, które zmieniasz, i reference_image_url dla twarzy — wysłane do spicyapi/face-swap-pro-v1/edit. Wywołanie jest asynchroniczne: zwraca identyfikator zadania, ty odpytujesz to zadanie, a każde żądanie zwraca jeden obraz, rozliczany za obraz wyjściowy.

Silnik dopasowuje twarz po punktach kluczowych

Pro powstał do precyzyjnej pracy. Zamiast przeklejać obszar, znajduje punkty kluczowe twarzy na obu zdjęciach i nakłada jeden zestaw na drugi, dzięki czemu oczy, nos i usta trafiają tam, gdzie umieszcza je geometria twarzy docelowej. Na tym endpoincie wykrywanie jest automatyczne: wysyłasz dwa obrazy i nic więcej. Nie ma też późniejszego upiększania, więc pory, drobne zmarszczki i ziarno zostają, a twarz jest tak samo ostra jak wszystko wokół. Z tego samego powodu wynik może wyglądać mniej pochlebnie niż zamiana z filtrem — dokładność i upiększanie to różne cele.

Dwa URL-e obrazów i nic więcej, co można zepsuć

To jedyny endpoint zamiany twarzy w tym katalogu, który przyjmuje wyłącznie dwa obrazy: bez promptu do sformułowania, bez obszaru do zamalowania, bez siły do ustawienia i bez seeda do przypięcia. Znika cała klasa błędów wynikających z niejasnych poleceń, a przetwarzanie wsadowe staje się banalne, bo lista par przechodzi bez decyzji dla każdego elementu. Nieznane klucze są odrzucane, a nie ignorowane, więc literówka w nazwie pola kończy się błędem przy wysyłaniu, zamiast po cichu przejść na wartość domyślną. Naprawdę liczy się tylko to, który URL trafia do którego pola: oba pola nie są symetryczne, a po zamianie żądanie nadal jest poprawne, tylko wynik jest zupełnie inny.

Zdjęcie docelowe przetrwa zamianę

Nie ma tu proporcji ani rozdzielczości do ustawienia, bo obraz nie jest generowany od nowa — podmienia się jeden obszar istniejącego zdjęcia. Dlatego endpoint nadaje się do ujęcia, które już zatwierdziłeś: nic poza twarzą nie wraca do gry.

Kadry redakcyjne i kampanijne do druku

Wygładzona twarz rozpada się w rozmiarze druku: obok ostrego ubrania i ostrego tła skóra wygląda jak plastik. Zachowana oryginalna tekstura sprawia, że kadr broni się, gdy ktoś ogląda go z bliska, a nie jako miniaturę.

Zmiana osoby w zatwierdzonym ujęciu

Światło, poza i scenografia już działają, a generowanie całego kadru od nowa znów otworzyłoby wszystkie te kwestie. Przenieś do ujęcia tylko twarz, a wszystko, co zatwierdziłeś, zostanie dokładnie na swoim miejscu.

Spójne postacie w serii

Wygeneruj sceny dowolnym modelem, a potem przenieś jedną twarz na wszystkie, żeby seria czytała się jako ta sama osoba. Włosy i strój zostają przy każdym obrazie docelowym, więc wygenerowana różnorodność przetrwa ten krok.

Kadry bez cenzury: granicą jest zgoda, nie temat

SpicyAPI nie dodaje własnego filtra treści i nie wymaga flagi treści, więc treść żądania to zawsze te same dwa pola, cokolwiek pokazuje kadr. Nie luzuje się autoryzacja: potrzebna jest wyraźna, świadoma zgoda przedstawionej osoby na to konkretne podobieństwo w tym konkretnym materiale, a zgody nigdy nie domniemuje się z faktu, że zdjęcie jest publiczne.

# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
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: $SPICY_IDEMPOTENCY_KEY" \
  -d '{
  "model": "spicyapi/face-swap-pro-v1/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "reference_image_url": "https://example.com/reference.png"
  }
}'

# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
  -H "Authorization: Bearer $SPICY_API_KEY"

Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.