Celebrity Look-Alike (look-alike-v1) macht aus einem Porträt ein generiertes Promi-Lookalike-Bild, für 0,05 $ je Anfrage. Die Antwort ist nur ein Bild: kein Feld mit einer Promi-ID, kein Ranking, kein Ähnlichkeitswert. Das Bild selbst kann ein zweigeteiltes Layout mit gedruckter Schlagzeile, einem Promi-Namen und einer handschriftlich wirkenden Signatur sein, und die Schrift kann verzerrt ausfallen. Berücksichtigen Sie das beim Gestalten der Share-Karte und stellen Sie den Namen nie als verifizierte Identifikation dar.
Look-Alike eignet sich für eine freiwillige Unterhaltungsfunktion: Selfie hochladen, ein teilbares Bild erhalten. Es gibt keinen Prompt, keine Auswahl einer Zielperson und keinen Stärkeregler. Verwenden Sie für einen gezielten Kleidungswechsel oder eine wiederkehrende fiktive Figur einen Bildeditor.
Die richtige Art von „Look-alike“-API wählen
Die meisten Look-alike-Tools sind eines von zwei anderen Dingen. Gesichtserkennungsdienste und Open-Source-Projekte wandeln ein Gesicht in einen Vektor um, durchsuchen eine Promi-Datenbank und liefern Namen mit Scores. Verbraucher-Finder zeigen Prozentwerte wie „92 % Übereinstimmung“ ohne erkennbare Methode. Look-Alike tut keins von beidem.
| Ihr Ziel | Passendes Werkzeug |
|---|---|
| Ein generiertes, teilbares Lookalike-Bild aus einem Foto | Look-Alike |
| Gerankte Promi-Namen oder eine Ähnlichkeitszahl | Einen Erkennungsdienst oder eine eigene Embedding-Suche über eine Datenbank, zu deren Nutzung Sie berechtigt sind; Look-Alike liefert beides nicht |
| Das Gesicht einer Person auf einem von Ihnen gewählten Zielbild | Einen Face-Swap-Endpunkt |
Was der Endpunkt akzeptiert
| Punkt | Aktuelle Schnittstelle |
|---|---|
| Modell-ID | spicyapi/look-alike-v1/edit |
| Eingabe | Ein image_url: JPG, PNG, WEBP oder GIF, bis 10 MB |
| Preis | 0,05 $ je Anfrage, auch wenn Ihnen das Ergebnis nicht gefällt |
| Nicht verfügbar | Prompt, Promi-Ziel, Seed, Größe, Stärke, Ähnlichkeit |
| Aufbewahrung | Quellbilder werden nach 1 Tag gelöscht, Ergebnisse nach 14 Tagen |
Ein Look-Alike-Beispielergebnis von der Modellseite: Das zurückgegebene Bild ist eine Collage mit Schlagzeile und zwei Feldern, in der der Name einer realen Person gedruckt ist. Ein Layout, das ein sauberes einzelnes Porträt voraussetzt, funktioniert damit nicht.
Das Beispiel auf der Modellseite ist eine Collage mit zwei Bildfeldern, gedrucktem Namen und Signatur. Rechnen Sie also mit Schrift im Bild und berücksichtigen Sie sie in der Gestaltung. Sehen Sie sich den tatsächlichen Export in der Größe Ihrer Karte an und behalten Sie die Proportionen bei: Eine Streckung ins Quadrat verzerrt die Gesichter. Auch wenn Sie die Schrift wegschneiden, ist das übrige Gesicht weiterhin keine verifizierte Übereinstimmung.
Das Quellfoto vorbereiten
Die Modellseite nennt die Fehlerfälle: Gruppenfotos, Profilansichten, Sonnenbrillen, Hände oder Haare vor dem Gesicht, Bewegungsunschärfe und sehr kleine Gesichter verschlechtern die Übereinstimmung oder lassen den Aufruf scheitern. Verwenden Sie ein einzelnes, gut beleuchtetes, ungefähr frontales Gesicht, das einen ausreichend großen Teil des Bildes füllt, mit sichtbaren Augen und sichtbarem Haaransatz. Wenden Sie Ausrichtung und Zuschnitt vor dem Upload an, denn eine Galerie-Vorschau kann Rotationsmetadaten ignorieren, die Ihre hochgeladenen Bytes weiterhin tragen. Ein winziges Gesicht aus einem Gruppenfoto zu vergrößern, fügt keine Details hinzu; bitten Sie stattdessen um ein neues Foto.
Illustration, kein Look-Alike-Ergebnis: Ein ungefähr frontales Porträt einer Erwachsenen zeigt einen geeigneten Bildausschnitt für die Eingabe.
Zuerst im Playground ausprobieren
- Öffnen Sie die Look-Alike-Seite und bleiben Sie im Tab Playground in der Ansicht Form. Melden Sie sich zum Ausführen mit einem aufgeladenen Konto an.
- Ziehen Sie das Porträt einer einwilligenden erwachsenen Person in Input image (JPG, PNG, WEBP oder GIF, bis 10 MB) oder fügen Sie über Asset URL einen direkten Link ein. Mehr ist nicht einzustellen.
- Führen Sie die Generierung aus, öffnen Sie dann das ganze zurückgegebene Bild und prüfen Sie es wie unten beschrieben.
Probieren Sie hier zuerst Ihr schwierigstes Quellfoto aus, bevor Sie Code schreiben: Ist das Ergebnis im Playground falsch, ist es das auch über die API, und die Lösung ist ein besseres Foto.
Dann aus dem Code aufrufen
Installieren Sie das Python-SDK (pip install spicyapi), setzen Sie SPICY_API_KEY in der Umgebung Ihres Servers und führen Sie Folgendes aus:
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())Übermitteln Sie nur image_url; zusätzliche Eigenschaften wie der Name einer prominenten Person werden abgelehnt. Uploads, Warten und Wiederholungsversuche sind im Leitfaden zu Aufgaben und in der Python-SDK-Referenz beschrieben. Für Webhooks lesen Sie den Vergleich von Polling und Webhooks. Ergebnisse werden nach 14 Tagen gelöscht. Kopieren Sie ein Bild deshalb in Ihren eigenen Speicher, wenn Nutzer es dauerhaft speichern möchten.
Oder einen Agenten ausführen lassen
Wenn ein Assistent die Anfragen ausführen soll: CLI und MCP-Server zeigen den Preis und fragen vor einem kostenpflichtigen Aufruf nach; der Skill liefert nur Anweisungen.
- CLI.
spicyapiführt eine Aufgabe im Terminal aus (npx @spicyapi/clifunktioniert ohne Installation). Legen Sie{"image_url": "spicy://..."}ininput.jsonab, mit der URI, die der Upload ausgibt:
``bash spicyapi files upload ./authorized-adult-portrait.jpg spicyapi tasks create --model spicyapi/look-alike-v1/edit --input-file input.json --wait ``
- MCP-Server. Fügen Sie den MCP-Server Ihrem Assistenten hinzu und sagen Sie dann: „Run Look-Alike on ./authorized-adult-portrait.jpg.“ Er ruft
spicyapi_upload_fileauf, dannspicyapi_task_create, das für Ihre Preisbestätigung anhält, und schließlichspicyapi_task_wait. - Skill.
npx skills add spicyapi-ai/spicy-skillinstalliert den Agent Skill, mit dem ein Coding-Assistent das aktuelle Modellschema liest, statt Felder zu raten. Er kann Aufgaben nicht selbst ausführen, verwenden Sie ihn also zusammen mit CLI oder MCP.
Das Ergebnis prüfen, bevor die Share-Karte entsteht
Öffnen Sie das ganze zurückgegebene Bild, nicht nur einen Gesichtsausschnitt. Achten Sie auf zusätzliche Bildfelder, Schlagzeilen, echte Namen, Signaturen, weitere Gesichter und ein verändertes scheinbares Alter. Beschriften Sie das Ergebnis mit Generated look-alike portrait (generiertes Lookalike-Porträt). Wenn der Name nicht erscheinen soll, schneiden Sie die Schrift ab oder decken Sie sie ab; das übrige Gesicht bleibt trotzdem keine verifizierte Übereinstimmung. Schreiben Sie nicht „93 % Übereinstimmung“ oder „verifizierte Promi-Identität“ daneben, und zeigen Sie keinen Namen, den ein anderes Modell aus dem Bild gelesen hat, als hätte Look-Alike ihn bewertet. Eingebettete Schrift ist generierter Inhalt und kann falsch sein.
Illustration, kein Look-Alike-Ergebnis: Prüfen Sie das ganze Bild und alles um das Gesicht herum, bevor Sie einen Export wählen.
Wenn der Teilnehmerin oder dem Teilnehmer das Bild nicht gefällt, bieten Sie an, es zu verwerfen oder ein anderes Foto zu versuchen. Nichts lenkt das Ergebnis zu einem gewählten Promi, eine Wiederholung ist also ein neuer Kandidat für 0,05 $ und keine Verfeinerung.
| Problem | Nächster Schritt |
|---|---|
| Anfrage abgelehnt | Prompt-, Seed-, Größen- und Namensfelder entfernen; nur image_url senden. |
| Quelle nicht abrufbar | Eine Login-Seite, eine abgelaufene URL oder eine HTML-Antwort durch ein erreichbares Bild oder eine spicy://-Referenz ersetzen. |
| Gesicht unklar oder falsche Person getroffen | Einen Ausschnitt mit einem einzelnen Gesicht aus einem ausreichenden Original verwenden oder um ein klareres Porträt bitten. |
| Name oder Signatur im Bild, die Sie nicht zeigen möchten | Das Teilen anhalten und die Darstellung ändern; der Name ist kein Antwortfeld, das Sie anfordern oder entfernen können. |
| Teilnehmer möchte eine bestimmte Figur oder ein bestimmtes Outfit | Stattdessen einen Bildeditor mit Referenzbildern verwenden. |
| Download eines fertigen Tasks schlägt fehl | Den Download wiederholen; keine neue Anfrage erstellen. |
Einwilligung und Teilen
Die Eingabe ist immer das Gesicht einer realen Person. Behandeln Sie die Funktion bei der Prüfung rechtlicher Pflichten also wie Gesichtserkennung. Biometrische Daten sind in der EU und in Teilen der USA gesondert reguliert; Illinois’ BIPA verlangt zum Beispiel schriftliche Information und eine informierte Einwilligung, bevor biometrische Identifikatoren erhoben werden. Verwenden Sie Fotos Erwachsener, die diesem Zweck bewusst zugestimmt haben, niemals Fotos von Personen des öffentlichen Lebens oder von anderswo übernommene Bilder, und nutzen Sie Look-Alike nicht zur Identifikation, Verifizierung, Überwachung oder zum Aufbau einer Gesichtsdatenbank. Behandeln Sie die Erlaubnis zum Generieren getrennt von der Erlaubnis, Quelle oder Ergebnis zu veröffentlichen.
Look-Alike läuft ohne Safety-Checker, Ihr Produkt muss also seine eigenen Alters- und Inhaltsregeln durchsetzen. Erstellen Sie aus Porträts realer Personen kein sexuelles, intimes oder rufschädigendes Material und stellen Sie das Ergebnis nicht als Aussage über eine reale Person dar. Ein Porträt einer vollständig bekleideten erwachsenen Person vom Brustbereich aufwärts ist die sichere Standardeingabe für eine öffentliche Unterhaltungsfunktion.
Bauen Sie einen schlanken Ablauf: eine private Vorschau der Quelle, einen Verarbeitungsstatus, das vollständige Ergebnis und eine ausdrückliche Speichern- oder Teilen-Aktion. Veröffentlichen Sie nicht automatisch, sobald die Generierung fertig ist.
