Einführung
Das Modell nimmt ein einzelnes Porträt und liefert ein erzeugtes Bild des ähnlichsten Promi-Doppelgängers. Es gibt keinen Prompt und keine Parameter: Das Foto ist die gesamte Eingabe.
Die Anfrage besteht aus einer Bild-URL und wird je Anfrage abgerechnet. Gebaut ist das als Funktion mit einem einzigen Aufruf für Unterhaltungs- und Social-Produkte, nicht als Werkzeug zur Identifizierung.
Wichtige Funktionen und Highlights
Ein Foto rein, ein Bild raus – mehr gibt es nicht zu senden
Die ganze Anfrage ist eine einzelne Bild-URL. Es gibt keinen Prompt, keinen Seed, keine Größe und keine Stärke; das hochgeladene Bild ist also das Einzige, was das Ergebnis beeinflusst. Senden Sie es ab und fragen Sie das Bild ab, genau wie bei jedem anderen Medienaufruf in diesem Katalog. Der Preis pro Anfrage bleibt gleich, egal wer im Bild zurückkommt.
Ein erzeugtes Bild, kein Name und kein Wert
Die Antwort enthält ein Bild und sonst nichts: keinen Promi-Namen, keine Rangliste von Kandidaten, keinen Ähnlichkeitswert in Prozent. Was neben dem Bild steht, ist Ihr eigener Text, keine Aussage des Modells – und so herum ist es sicherer. Bauen Sie den Moment auf dem Bild selbst auf: Zeigen Sie es, lassen Sie es teilen, und verzichten Sie darauf, eine Zahl daneben zu setzen.
Bei der Frage, ob Sie es nutzen dürfen, wie Gesichtserkennung behandeln
Die Eingabe ist immer das Gesicht eines echten Menschen. Damit fällt dieser Endpunkt unter Regeln zu Bildnis und biometrischen Daten, die sonst nichts in diesem Katalog berührt. Biometrische Daten sind in der Europäischen Union und in Teilen der USA gesondert geregelt, und die Anforderungen an die Einwilligung können dort hoch sein. Senden Sie nur Fotos, deren abgebildete Person wissentlich zugestimmt hat – nie die einer bekannten Persönlichkeit, nie Bilder, die von anderswo übernommen wurden –, und nutzen Sie den Endpunkt nie zur Identifizierung, Verifizierung, Überwachung oder zum Aufbau einer Gesichtsdatenbank. Nichts, was zurückkommt, ist eine Tatsachenaussage über einen echten Menschen; hochgeladene Ausgangsbilder werden nach einem Tag gelöscht, erzeugte Ergebnisse nach 14 Tagen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Ein klares, weitgehend frontales Porträt mit einem einzigen sichtbaren Gesicht. mindestens 1 Zeichen |
Preis
$0.05 / Anfrage
Auch ein Treffer, den Sie nicht gewählt hätten, gilt als abgeschlossene Anfrage und wird berechnet.
Anwendungsfälle
Ein Upload, ein Bild zum Teilen
Nutzen Sie diesen Endpunkt, wenn der Produktmoment aus einem einzigen Foto-Upload und einem erzeugten Bild zum Teilen besteht. Senden Sie das Porträt als image_url, fragen Sie die Task ab und zeigen Sie das zurückgelieferte Bild; einen Namen oder Wert, den Sie danebenstellen könnten, gibt es nicht.
Unterhaltungs- und Social-Funktionen
Die Interaktion „Welchem Promi sehen Sie ähnlich?“ als ein API-Aufruf hinter einem Foto-Upload. Das ist ein teilbarer Moment in einer Endkunden-App, kein Produktionswerkzeug.
Kampagnenmechaniken
Ein leichtgewichtiger interaktiver Schritt in einem Marketing-Ablauf: Selfie hochladen, Bild zum Teilen zurückbekommen. Ein Aufruf pro Teilnehmerin oder Teilnehmer hält die Kosten planbar.
Foto- und Beauty-Apps
Eine Spaßfunktion neben bestehenden Porträtwerkzeugen. Sie braucht kein Prompt-Engineering und keine Parameter und passt deshalb mit einem einzigen Formularfeld in eine App.
Prompt-Leitfaden und Praxistipps
Rechnen Sie mit einem Bild, nicht mit einem Urteil
Der Endpunkt liefert ein erzeugtes Bild, keinen Namen, keine Rangfolge und keinen Ähnlichkeitswert. Braucht Ihr Produkt eine Beschriftung, müssen Sie das Bild selbst präsentieren – die API gibt Ihnen nichts anderes zum Anzeigen.
Ein klares, frontales Porträt senden
Ein einzelnes, gut beleuchtetes Gesicht, ungefähr zur Kamera gewandt, das einen ordentlichen Teil des Bildes ausfüllt. Gruppenfotos, starke Profile, Sonnenbrillen, Bewegungsunschärfe und sehr kleine Gesichter sind die Fälle, in denen der Abgleich schlechter wird oder der Aufruf ganz scheitert.
Das Ergebnis prüfen, bevor Sie iterieren
Ein Gesicht pro Bild, ungefähr frontal und klar beleuchtet. Profilwinkel, Verdeckungen (Sonnenbrille, Hände, Haare im Gesicht), Bewegungsunschärfe und sehr kleine Gesichter verschlechtern den Abgleich oder lassen den Aufruf scheitern. Es gibt keinen Prompt, keine Maske, keine Stärke und keinen Seed: Stimmt das Ergebnis nicht, hilft nur ein anderes Foto. Die Antwort ist ein Bild und sonst nichts – kein Name, keine Rangfolge, kein Konfidenzwert.
API-Schnellstart
# 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/look-alike-v1/edit",
"input": {
"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"
Authentifizierung, vollständiges Schema, Polling und Fehlerbehandlung stehen in der API-Referenz.