Face Swap Plus API

Przenosi twarz z jednego obrazu na osobę na innym i przy okazji wyrównuje między nimi odcień skóry. O zakresie przeniesienia decyduje silnik: wtapia samą twarz albo całą głowę, zależnie od tego, co w danej parze wygląda naturalniej, więc linia włosów nie zawsze zostaje nietknięta. Poza, strój, światło i tło obrazu docelowego zostają bez zmian.

Face Swap Plus to sterowalny poziom linii Face Swap. Oprócz dwóch obrazów przyjmuje krótkie polecenie tekstowe, format pliku wyjściowego i seed, a wysyła się go do spicyapi/face-swap-v1-plus/edit. Wywołanie jest asynchroniczne: zwraca identyfikator zadania, ty odpytujesz to zadanie, a każde żądanie zwraca jeden obraz, rozliczany za obraz wyjściowy niezależnie od wybranego formatu.

Odcień skóry wyrównuje się sam

Zamiana twarzy najczęściej zdradza się na granicy: referencja zrobiona w ciepłym świetle, wstawiona do obrazu w chłodnym świetle, zostawia obwódkę wokół żuchwy i szyję, która nie pasuje już do głowy. Ten silnik wyrównuje odcień obu zdjęć w trakcie przenoszenia, więc para podobna, ale nie identyczna, zwykle wypada dobrze bez ręcznej korekty koloru. Kierunek światła nadal ma znaczenie — twarz oświetlona z drugiej strony wciąż wygląda źle — ale najczęstsza niezgodność jest już załatwiona.

Głębokość wtopienia zapada osobno dla każdej pary

To inteligentna zamiana głowy: dla każdej pary silnik ocenia, czy naturalniej wypadnie wtopienie samej twarzy, czy całej głowy, i nie ma ustawienia, które wymusiłoby jedno albo drugie. Na tym polega praktyczna różnica wobec reszty linii, w której linia włosów zawsze zostaje z obrazu docelowego. Dlatego też wynik może wrócić z nieco inną linią włosów, niż się spodziewałeś — silnik uznał pełniejsze wtopienie za bardziej wiarygodne.

Masowe pipeline’y awatarów i zdjęć profilowych

Lista par obraz docelowy–referencja przechodzi przez endpoint programowo, jedno wywołanie na parę. Przypnij seed dla pary, gdy ponowna próba ma być porównywalna z pierwszą, i wybierz WebP, gdy wyniki trafiają prosto do sieci.

Funkcje konsumenckie za formularzem przesyłania

Cała interakcja to jedno zdjęcie od użytkownika i jeden obraz, który dostarczasz ty. Użytkownik nie ma nic do ustawienia ani promptu do napisania, więc cała funkcja to jedno pole formularza i zadanie w tle.

Katalogi i szablony

Ta sama twarz referencyjna na serii przygotowanych obrazów daje spójną serię bez generowania któregokolwiek od nowa. Ustawienie formatu wyjściowego dostarcza pliki w postaci, której twój pipeline już oczekuje; akcesorium wymagane przez szablon musi być w obrazie przed zamianą.

Kadry bez cenzury: granicą jest zgoda, nie temat

SpicyAPI nie dodaje własnego filtra treści i nie wymaga flagi dojrzałości, więc treść żądania zawiera te same pola, niezależnie od tego, co pokazuje kadr. Nie łagodzi się natomiast wymogu uprawnień: potrzebujesz wyraźnej, świadomej zgody przedstawionej osoby na użycie tej konkretnej twarzy w tym konkretnym materiale, a publiczne zdjęcie nigdy nie oznacza zgody.

# 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-v1-plus/edit",
  "input": {
    "image_url": "https://example.com/reference.png",
    "output_format": "jpeg",
    "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.