GesichtsverbesserungÜber Face Enhancer
Face Enhancer restauriert und schärft bis zu drei Gesichter in einem Foto, das größte zuerst. Nichts anderes im Bild ändert sich, die Auflösung bleibt gleich, und du bekommst das Ergebnis als JPEG, PNG oder WebP. Es gibt keinen Prompt zu schreiben.
Du rufst es mit dem Modellnamen popnow/face-enhancer-v1/edit über POST /jobs/createTask auf, ab 0,012 $.
Diese Anleitung gibt es vorerst nur auf Englisch. →
Anfrageparameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Das Bild, von dem aus es losgeht. |
output_format | Nein | Dateiformat des Ergebnisses. jpeg · png · webp · Standardwert: jpeg |
Preise
Die Preise sind in USD angegeben. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.
| Option | USD pro Bild |
|---|---|
| Standard | 0,012 $ |
Sende vor dem Start denselben Anfrage-Body an POST /jobs/quote, um die geschätzten und maximalen Kosten in USD zu sehen. Die Preisabfrage führt keine Aufgabe aus und belastet dein Guthaben nicht.
API-Schnellstart
Die Face Enhancer API in drei Schritten aufrufen
- API-Schlüssel erstellen. Melde dich bei PopNow an und erstelle in der API-Konsole einen Schlüssel. Schlüssel beginnen mit sk-popnow-. API-Aufrufe nutzen dein separates Guthaben in US-Dollar.
- Anfrage senden. Sende POST /jobs/createTask mit model popnow/face-enhancer-v1/edit und einem input-Objekt nach der Parametertabelle. Die Antwort enthält sofort eine Task-ID.
- Ergebnis abholen. Frage GET /jobs/recordInfo mit der Task-ID ab oder gib eine callBackUrl mit, dann schicken wir das Ergebnis dorthin. Lade die Ausgabelinks herunter, sobald die Aufgabe erfolgreich ist.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "popnow/face-enhancer-v1/edit",
"input": {
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"output_format": "jpeg"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Ersetze den Prompt und alle Links durch deine eigenen. Im Tab „API“ findest du die Referenz zu Antwort, Polling und Callback.
Fragen zur Face Enhancer API
Was kostet die Face Enhancer API?
Face Enhancer kostet 0,012 $ pro Bild. Die API nutzt ein separates Guthaben in US-Dollar. Website-Credits lassen sich dafür weder verwenden noch in API-Guthaben umwandeln. Auch die umgekehrte Übertragung ist nicht möglich. Bei Annahme einer Aufgabe reservieren wir den maximalen Angebotsbetrag aus deinem API-Guthaben. Nach Abschluss rechnen wir den tatsächlichen Verbrauch ab, höchstens den reservierten Betrag, und geben den Rest frei. Schlägt die Aufgabe fehl, wird die Reservierung aufgehoben.
Wie lautet der Modellname von Face Enhancer in der API?
Trag popnow/face-enhancer-v1/edit für Gesichtsverbesserung im Feld model von POST /jobs/createTask ein.
Macht es mein Foto größer?
Nein. Das Ergebnis kommt in der Auflösung zurück, die Sie senden: Unser Testfoto mit 720×404 kam mit 720×404 zurück. Für mehr Pixel nutzen Sie Image Upscaler unter /models/image-upscaler-v1.
Wie viele Gesichter werden korrigiert?
Bis zu drei, das größte zuerst. Weitere Gesichter im Foto bleiben ebenso wie alles andere außerhalb der Gesichter unverändert.
Sieht die Person danach noch aus wie sie selbst?
In unseren Tests blieben die Gesichter eindeutig wiedererkennbar dieselben Personen. Details werden neu aufgebaut, vergleichen Sie das Ergebnis deshalb mit Ihrem Original, bevor Sie es veröffentlichen.
Was bleibt unangetastet, und was wird weicher?
Der Hintergrund bleibt unberührt: In unserem Test behielt das Flaschenregal hinter der Person seine ursprünglichen Kompressionsblöcke. Die Haut im Gesicht kam etwas glatter zurück, als es bei einem echten Foto der Fall wäre.
Kann ich Face Enhancer testen, ohne Code zu schreiben?
Teste Face Enhancer im Playground mit deinem API-Guthaben in USD, ganz ohne API-Schlüssel. Jeder Lauf erscheint mit dem passenden Code im Entwicklerverlauf.
Alle Face Enhancer-Modelle
Image Upscaler vergrößert das ganze Bild; Face Enhancer repariert Gesichter bei gleicher Größe.