Celebrity Look-Alike (look-alike-v1) zamienia jeden portret w wygenerowany obraz sobowtóra celebryty, za 0,05 USD za żądanie. Odpowiedź to wyłącznie obraz: bez pola z ID celebryty, bez rankingu, bez wyniku podobieństwa. Sam obraz może mieć układ z dwoma panelami, z wydrukowanym nagłówkiem, imieniem i nazwiskiem celebryty oraz podpisem w stylu odręcznym, a napisy mogą wyjść zniekształcone. Zaplanuj kartę do udostępniania z uwzględnieniem tego i nigdy nie przedstawiaj nazwiska jako zweryfikowanej identyfikacji.
Look-Alike pasuje do dobrowolnej funkcji rozrywkowej: użytkownik przesyła selfie i dostaje obraz do udostępnienia. Nie ma promptu, wyboru osoby docelowej ani regulacji siły; do ukierunkowanej zmiany ubioru lub powracającej fikcyjnej postaci użyj edytora obrazów.
Wybierz właściwy rodzaj API „sobowtóra”
Większość narzędzi do szukania sobowtórów to w rzeczywistości jedna z dwóch innych rzeczy. Usługi rozpoznawania twarzy i projekty open source zamieniają twarz w wektor, przeszukują bazę celebrytów i zwracają nazwiska z wynikami. Konsumenckie wyszukiwarki pokazują procenty, np. „92% zgodności”, bez żadnej metody. Look-Alike nie robi żadnej z tych rzeczy.
| Potrzebujesz | Użyj |
|---|---|
| Wygenerowanego, nadającego się do udostępnienia obrazu sobowtóra z jednego zdjęcia | Look-Alike |
| Uszeregowanych nazwisk celebrytów lub liczby podobieństwa | Usługi rozpoznawania lub własnego wyszukiwania po embeddingach w bazie, którą wolno ci licencyjnie przechowywać; Look-Alike nie zwraca żadnego z nich |
| Twarzy jednej osoby umieszczonej na wybranym przez ciebie obrazie docelowym | Endpointu face swap |
Co przyjmuje endpoint
| Element | Obecny kontrakt |
|---|---|
| ID modelu | spicyapi/look-alike-v1/edit |
| Dane wejściowe | Jedno image_url: JPG, PNG, WEBP lub GIF, do 10 MB |
| Cena | 0,05 USD za żądanie, naliczane także wtedy, gdy dopasowanie ci się nie podoba |
| Niedostępne | Prompt, docelowy celebryta, seed, rozmiar, siła, podobieństwo |
| Przechowywanie | Obrazy źródłowe są usuwane po 1 dniu, wyniki po 14 dniach |
Przykładowy wynik Look-Alike ze strony modelu: zwrócony obraz to kolaż z nagłówkiem i dwoma panelami, z wydrukowanym nazwiskiem prawdziwej osoby, więc układ zakładający czysty pojedynczy portret się rozsypie.
Przykład na stronie modelu to kolaż z dwoma panelami, wydrukowanym nazwiskiem i podpisem, więc spodziewaj się napisów i zaplanuj je. Obejrzyj faktyczny eksport w rozmiarze swojej karty, zachowaj jego proporcje (rozciągnięcie do kwadratu zniekształca twarze), a jeśli wytniesz napisy, pozostała twarz nadal nie jest zweryfikowanym dopasowaniem.
Przygotuj zdjęcie źródłowe
Strona modelu wymienia przypadki niepowodzeń: zdjęcia grupowe, profile, okulary przeciwsłoneczne, dłonie lub włosy zasłaniające twarz, rozmycie ruchu i bardzo małe twarze pogarszają dopasowanie albo powodują błąd wywołania. Użyj jednej, dobrze oświetlonej, mniej więcej frontalnej twarzy, która wypełnia rozsądną część kadru, z widocznymi oboma oczami i linią włosów. Zastosuj obrót i przycięcie przed przesłaniem, bo miniatura w galerii może ignorować metadane obrotu, które przesłane bajty nadal zawierają. Powiększenie maleńkiej twarzy ze zdjęcia grupowego nie dodaje szczegółów; poproś o nowe zdjęcie.
Ilustracja, nie wynik Look-Alike: mniej więcej frontalny portret dorosłej osoby pokazuje czytelny kadr wejściowy.
Najpierw wypróbuj w Playground
- Otwórz stronę Look-Alike i zostań na karcie Playground, w widoku Form. Aby uruchomić, zaloguj się na konto z saldem.
- Upuść portret dorosłej osoby, która wyraziła zgodę, w polu Input image (JPG, PNG, WEBP lub GIF, do 10 MB) albo wklej bezpośredni link w Asset URL. Niczego więcej nie trzeba ustawiać.
- Uruchom, potem otwórz cały zwrócony obraz i sprawdź go tak, jak opisano niżej.
Wypróbuj tu swoje najtrudniejsze zdjęcie źródłowe, zanim napiszesz kod: jeśli dopasowanie jest złe w Playground, będzie złe także przez API, a rozwiązaniem jest lepsze zdjęcie.
Potem wywołaj z kodu
Zainstaluj SDK dla Pythona (pip install spicyapi), ustaw SPICY_API_KEY w środowisku serwera i uruchom:
import urllib.request
import uuid
from spicyapi import SpicyClient, output_assets
client = SpicyClient() # reads SPICY_API_KEY from the environment
photo = client.upload_file("./authorized-adult-portrait.jpg") # becomes a spicy:// URI
task = client.create_task(
model="spicyapi/look-alike-v1/edit",
input_data={"image_url": photo["uri"]},
idempotency_key=str(uuid.uuid4()), # new key per new request; reuse only to retry the same one
)
final = client.wait_for_terminal(task["taskId"])
if final["state"] != "succeeded":
raise RuntimeError(f"Task {task['taskId']} ended as {final['state']}")
url = output_assets(final)[0]["url"]
# some script clients get 403 without a User-Agent
request = urllib.request.Request(url, headers={"User-Agent": "look-alike-example/1.0"})
with urllib.request.urlopen(request) as response, open("look-alike.webp", "wb") as out:
out.write(response.read())Przesyłaj tylko image_url; dodatkowe właściwości, takie jak nazwisko celebryty, są odrzucane. Przesyłanie plików, oczekiwanie i ponowne próby opisano w przewodniku po zadaniach i dokumentacji SDK dla Pythona. Webhooki opisuje porównanie odpytywania i webhooków. Wyniki są usuwane po 14 dniach, dlatego skopiuj obraz do własnego magazynu, jeśli użytkownik chce go zachować.
Albo pozwól uruchomić to Agentowi
Gdy żądania ma uruchamiać asystent, CLI i serwer MCP pokazują cenę i pytają o zgodę przed płatnym wywołaniem; Skill dodaje tylko instrukcje.
- CLI.
spicyapiuruchamia jedno zadanie z terminala (npx @spicyapi/clidziała bez instalacji). Umieść{"image_url": "spicy://..."}winput.json, używając URI wypisanego po przesłaniu:
``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``
- Serwer MCP. Dodaj serwer MCP do swojego asystenta, a potem poproś: „Run Look-Alike on ./authorized-adult-portrait.jpg.” Wywoła
spicyapi_upload_file, następniespicyapi_task_create, które zatrzyma się na potwierdzenie ceny, a potemspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstaluje Agent Skill, dzięki któremu asystent programistyczny czyta aktualny schemat modelu zamiast zgadywać pola. Sam nie uruchamia zadań, więc używaj go razem z CLI lub MCP.
Sprawdź wynik przed kartą do udostępnienia
Otwórz cały zwrócony obraz, nie wycinek twarzy. Szukaj dodatkowych paneli, nagłówków, prawdziwych nazwisk, podpisów, dodatkowych twarzy i zmienionego pozornego wieku. Oznacz wynik jako Generated look-alike portrait (wygenerowany portret sobowtóra). Jeśli nie chcesz pokazywać nazwiska, wytnij lub zasłoń napisy; pozostała twarz nadal nie jest zweryfikowanym dopasowaniem. Nie dopisuj obok „93% zgodności” ani „zweryfikowana tożsamość celebryty” i nie pokazuj nazwiska odczytanego z obrazu przez inny model tak, jakby ocenił je Look-Alike. Wbudowane napisy to wygenerowana treść i mogą być błędne.
Ilustracja, nie wynik Look-Alike: przejrzyj cały obraz i wszystko wokół twarzy, zanim wybierzesz eksport.
Jeśli uczestnikowi obraz się nie podoba, zaproponuj jego odrzucenie lub spróbowanie z innym zdjęciem. Nic nie kieruje wyniku w stronę wybranego celebryty, więc powtórka to nowy kandydat za 0,05 USD, a nie dopracowanie.
| Problem | Następny krok |
|---|---|
| Żądanie odrzucone | Usuń pola prompt, seed, rozmiar i nazwisko; wyślij tylko image_url. |
| Nie można pobrać źródła | Zamień stronę logowania, wygasły URL lub odpowiedź HTML na dostępny obraz albo odwołanie spicy://. |
| Niewyraźna twarz lub dopasowano złą osobę | Użyj wycinka z jedną twarzą z wystarczającego oryginału albo poproś o wyraźniejszy portret. |
| Nazwisko lub podpis na obrazie, których nie chcesz pokazywać | Wstrzymaj udostępnianie i zmień prezentację; nazwisko nie jest polem odpowiedzi, o które możesz poprosić lub które możesz usunąć. |
| Uczestnik chce konkretnej postaci lub ubioru | Użyj zamiast tego edytora obrazów obsługującego obrazy referencyjne. |
| Pobieranie ukończonego zadania się nie udaje | Ponów pobieranie; nie twórz nowego żądania. |
Zgoda i udostępnianie
Dane wejściowe to zawsze twarz prawdziwej osoby, więc przy ocenie obowiązków prawnych traktuj tę funkcję jak rozpoznawanie twarzy. Dane biometryczne są osobno regulowane w UE i w części Stanów Zjednoczonych; na przykład BIPA w Illinois wymaga pisemnej informacji i świadomej zgody przed zbieraniem identyfikatorów biometrycznych. Używaj zdjęć dorosłych, którzy świadomie zgodzili się na ten cel, nigdy zdjęć osób publicznych ani obrazów pobranych skądinąd, i nie używaj Look-Alike do identyfikacji, weryfikacji, nadzoru ani budowania bazy twarzy. Traktuj zgodę na generowanie jako odrębną od zgody na publikację źródła lub wyniku.
Look-Alike działa bez kontroli bezpieczeństwa, więc twój produkt musi egzekwować własne zasady dotyczące wieku i treści. Nie używaj portretów prawdziwych osób do tworzenia materiałów seksualnych, intymnych ani zniesławiających i nie przedstawiaj wyniku jako twierdzenia o prawdziwej osobie. W pełni ubrany portret dorosłej osoby od piersi w górę to bezpieczne domyślne wejście dla publicznej funkcji rozrywkowej.
Zbuduj wąski przepływ: prywatny podgląd źródła, stan przetwarzania, pełny wynik i wyraźną akcję zapisu lub udostępnienia. Nie publikuj automatycznie po zakończeniu generowania.
