Wprowadzenie
Head Swap zastępuje całą głowę osoby na obrazie docelowym głową ze zdjęcia referencyjnego. Przenoszone są twarz, fryzura, kolor włosów i sylwetka czaszki; ciało, strój, poza, światło i tło obrazu docelowego zostają bez zmian.
Żądanie to dwa URL-e obrazów i opcjonalny seed: image_url to ciało, które zostaje, a reference_image_url dostarcza głowę. Nie ma promptu, maski ani ustawienia siły, a każde żądanie zwraca jeden obraz.
Najważniejsze funkcje
Cała głowa postaci w istniejącym ujęciu
Head Swap zmienia więcej niż tożsamość twarzy: to właściwy zakres, gdy włosy, ich kolor i sylwetka głowy nowej postaci muszą przyjść razem z nią. Dlatego sprawdza się przy zmianie obsady, koncepcjach kostiumów i dbaniu o ciągłość, gdy fryzura z obrazu docelowego nie ma zostać.
Przejście szyi to test akceptacji
Wybieraj materiał o zgodnym kącie kamery i kierunku światła, z widoczną szyją. Zanim przyjmiesz wynik, sprawdź w pełnym rozmiarze linię włosów, uszy, żuchwę, szew na szyi i ciągłość cieni — to na tych granicach widać, czy oba obrazy naprawdę do siebie pasują.
Zacznij od kontrolowanej pary obrazów
Zacznij od jednej wyraźnej osoby na każdym obrazie i unikaj mocnego rozmycia, zasłonięć czy skrajnych profili. Gdy własne włosy i sylwetka z obrazu docelowego są dla ujęcia kluczowe, wybierz Face Swap zamiast wymuszać zamianę całej głowy.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Obraz, który jest zmieniany. Jego ciało, ubiór, poza, światło i tło zostają zachowane; wszystko powyżej szyi zostaje zastąpione. od 1 znaków |
reference_image_url | Tak | Obraz dostarczający całą głowę, razem z jej kształtem, fryzurą i kolorem włosów. od 1 znaków |
seed | Nie | Użyj ponownie tego samego seeda, żeby porównać dwa przebiegi na tej samej parze obrazów przy identycznym losowaniu; zostaw pole puste albo ustaw 0, by losować za każdym razem. |
Cennik
$0.013 / obraz
Zastosowania
Zamiana całej głowy, nie tylko twarzy
Używaj tego endpointu, gdy fryzura, kolor włosów i sylwetka głowy nowej osoby muszą przyjść razem z nią. Zanim przyjmiesz wynik, sprawdź w pełnym rozmiarze linię włosów, uszy i szew na szyi; jeśli włosy z obrazu docelowego należą do ujęcia, węższym narzędziem jest Face Swap.
Nowa głowa w ujęciu ciała, które ci się podoba
Gdy strój, poza i światło na obrazie już działają, zamiana głowy jest tańsza i bardziej przewidywalna niż generowanie całego obrazu od nowa z nadzieją, że kompozycja przetrwa.
Ujęcia kostiumowe i cosplay
Umieść głowę i fryzurę postaci na ciele w kostiumie, który wygenerowałeś. Strój pokojówki, poza i scenografia kawiarni zostają dokładnie takie, jakie były, więc praca nad strojem przetrwa ten krok.
Dowolna scena z twarzą, na którą jest zgoda
Przenieś głowę, której masz prawo użyć, do kadrów, które sam wyprodukowałeś, niezależnie od tego, co pokazują. Endpoint nie traktuje tego materiału inaczej — decyduje wymóg zgody z ograniczeń poniżej i nie jest to formalność.
Wskazówki
Upewnij się, że masz prawa do obu osób
Oba obrazy przedstawiają osobę, a ty potrzebujesz zgody zarówno na przenoszoną głowę, jak i na kadr, do którego ją przenosisz. Zanim zaczniesz integrację, przechowuj zgodę razem z dokumentacją zadania.
Dopasuj kąty, potem wyślij parę
image_url to ciało, które zostaje; reference_image_url dostarcza głowę. Ogólny edytor obrazów potrzebowałby polecenia w rodzaju: „Head swap: replace the entire head of the person in the first image — face, hairstyle and hair colour — with the head from the second image, keeping the first image's body, maid outfit, pose, cafe background, lighting and colour grade unchanged. Match the neck seam, skin tone and lighting direction so the result reads as one photograph.” Tutaj pola promptu w ogóle nie ma.
Sprawdź wynik, zanim zaczniesz iterować
Słabym punktem jest szew na szyi: obraz docelowy z szyją zakrytą wysokim kołnierzem, szalikiem lub włosami albo z głową ustawioną pod wyraźnie innym kątem niż na referencji daje widoczne łączenie. Dopasuj kierunek światła i odcień skóry obu źródeł i wybieraj podobne kąty głowy. Oba obrazy potrzebują wyraźnie widocznej, mniej więcej frontalnej, dobrze oświetlonej głowy odpowiedniej wielkości; na zdjęciu grupowym endpoint nie wie, o którą osobę chodzi. Jeśli fryzura z obrazu docelowego ma zostać, użyj Face Swap — żaden parametr tutaj jej nie zachowa. Nie ma promptu, maski ani ustawienia siły, więc zły wynik naprawia się inną parą obrazów.
Szybki start z API
# 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/head-swap-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.
