Einführung
Was dieser Endpoint macht
Er wendet ein Modell von Topaz Labs auf ein Foto an. Die Denoise-Presets entfernen Korn, ISO-Rauschen und Kompressionssprenkel; die Sharpen-Presets holen verlorene Schärfe nach Fokusfehlern, Verwacklung oder Objektivunschärfe zurück. Breite und Höhe der Ausgabe entsprechen der Eingabe.
Wichtige Eingaben
image_url erwartet ein JPEG, PNG oder WebP mit höchstens 24 Megapixeln, hochgeladen oder als öffentlicher Link. preset bestimmt das Modell, Standard ist denoise_normal. output_format ist jpeg (Standard) oder png.
Was zurückkommt
Ein Bild pro Anfrage, bereitgestellt aus dem Plattformspeicher, sobald der asynchrone Task fertig ist. Bilder über 24 Megapixeln werden beim Einreichen mit invalid_request abgelehnt.
| Feld | Wert |
|---|---|
| Eingabe | Bild |
| Ausgabe | Bild |
| Endpoint | Bildbearbeitung |
| Presets | 3 Entrauschungsstufen, 8 Schärfungsmodelle |
| Prompt | Keiner |
| Abrechnung | Festpreis pro Bild |
Wichtige Funktionen und Highlights
Barfoto bei Kerzenlicht: Farbrauschen weg, Gesicht unverändert
Wir haben ein Porträt mit 2048×1152 unter starkem Farbrauschen begraben und durch Denoise Normal geschickt. Die Sprenkel auf dem Pullover und im dunklen Weinregal verschwanden, Augen, Creole und Bokeh-Lichter blieben an ihrem Platz. Die Sommersprossen wirkten danach blasser als im sauberen Original.
Filmartige Körnung von einem Café-Porträt entfernt
Ein WebP mit 1024×1536 und feinem Graukorn über Haut, Haaren und Strickpullover lief in rund 25 Sekunden durch Denoise Strong. Das Korn war weg, die Locken behielten ihre Strähnen und der Pullover sein Maschenbild; die Haut wurde etwas glatter.
Sharpen Standard holt ein weiches Gesicht zurück in die Schärfe
Ein absichtlich weichgezeichnetes Porträt hatte nach 14 Sekunden wieder erkennbare Augen, Brauen und Bartstoppeln. Solche Details rekonstruiert das Modell, prüfen Sie das Ergebnis deshalb in voller Größe, bevor Sie sich darauf verlassen.
Request-Parameter
| Parameter | Pflicht | Beschreibung |
|---|---|---|
image_url | Ja | Das zu bereinigende Foto: JPEG, PNG oder WebP als Upload oder öffentlicher Link, höchstens 24 Megapixel (6000×4000 passt). mindestens 1 Zeichen |
preset | Nein | Welches Topaz-Modell läuft. |
output_format | Nein | jpeg (Standard) oder png. png vermeidet eine weitere verlustbehaftete Kompression und erzeugt eine größere Datei. |
Preis
$0.12 / Bild
Jedes fertige Bild kostet denselben Festbetrag, egal welches der elf Presets oder welches der beiden Ausgabeformate Sie wählen; fehlgeschlagene oder abgelehnte Anfragen kosten nichts.
Anwendungsfälle
Handyfotos bei Nacht und in Innenräumen
Bilder mit hoher ISO von Konzerten, aus Restaurants oder dunklen Wohnzimmern wirken fleckig. Beginnen Sie mit Denoise Normal und wechseln Sie zu Strong, wenn die Schatten danach noch gesprenkelt sind.
Körnung auf KI-generierten Bildern
Manche Bildmodelle hinterlassen feines Korn oder ein sich wiederholendes Muster auf Haut und glatten Hintergründen. Ein Denoise-Durchgang liefert eine sauberere Basis, bevor Sie hochskalieren, zuschneiden oder drucken.
Aufnahmen, die fast scharf sind
Leicht danebenliegender Fokus, etwas Verwacklung oder ein weiches Objektiv: Sharpen Standard deckt die milden Fälle ab, Motion Blur und Lens Blur zielen genau auf diese beiden Probleme, Portrait und Wildlife sind auf Haut beziehungsweise Fell abgestimmt.
Prompt-Leitfaden und Praxistipps
Größe prüfen
Senden Sie ein JPEG, PNG oder WebP mit höchstens 24 Megapixeln, als Upload oder öffentlichen Link. Größere Dateien werden beim Einreichen abgelehnt, verkleinern Sie sie also vorher.
Ein Preset wählen
Nehmen Sie ein denoise_-Preset gegen Korn und Sprenkel und ein sharpen_-Preset gegen Unschärfe. Jede Anfrage führt genau ein Preset aus; brauchen Sie beides, entrauschen Sie zuerst und schicken das Ergebnis dann zum Schärfen.
Abfragen und vergleichen
Legen Sie den Task an, fragen Sie den Status ab, bis er fertig ist, und laden Sie die Datei aus dem Plattformspeicher. Vergleichen Sie sie bei 100 % Zoom mit der Quelle, vor allem an Augen, Haaren und feinen Texturen.
Einführung
Topaz Denoise & Sharpen bündelt zwei Modellfamilien von Topaz Labs in einem Endpoint. Denoise entfernt Rauschen und Korn und versucht dabei echte Details zu halten; Sharpen bringt Klarheit zurück, die durch Fokusfehler, Bewegung oder ein weiches Objektiv verloren ging. Das Modell wählen Sie mit preset; einen Prompt gibt es nicht.
Anfrage
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Presets
| preset | Geeignet für |
|---|---|
denoise_normal | Alltägliches Rauschen bei wenig Licht oder durch Kompression (Standard) |
denoise_strong | Sehr dunkle Aufnahmen oder hohe ISO; erhält mehr Details als Extreme |
denoise_extreme | Stark beschädigte oder hart komprimierte Bilder |
sharpen_standard | Leichte Unschärfe oder kleine Verwacklung; der übliche Einstieg |
sharpen_strong | Deutlich verfehlter Fokus |
sharpen_natural | Zurückhaltendes Schärfen, das organische Texturen bewahrt |
sharpen_portrait | Gesichter und Haut |
sharpen_wildlife | Fell, Federn und andere Naturdetails |
sharpen_refocus | Feine Details in leicht defokussierten Bildern |
sharpen_motion_blur | Unschärfe durch Kamera- oder Motivbewegung |
sharpen_lens_blur | Defokus und Objektivunschärfe |
Unsere Tests
Ein Porträt bei Kerzenlicht mit 2048×1152 und stark hinzugefügtem Farbrauschen kam mit denoise_normal nach etwa 19 Sekunden sauber zurück; Augen, Ohrringe und Bokeh-Lichter hielten, die Sommersprossen wurden blasser. Ein Café-Porträt mit 1024×1536 und feinem Korn, als WebP gesendet, verlor mit denoise_strong in rund 25 Sekunden das Korn, Locken und Strickmuster blieben erhalten. Ein absichtlich weichgezeichnetes Porträt mit 1100×900 bekam mit sharpen_standard in 14 Sekunden Augen und Bartstoppeln zurück. Alle drei kamen in ihrer Eingabegröße zurück.
Grenzen
Eingaben sind auf 24 Megapixel begrenzt (6000×4000 passt); größere Bilder werden abgelehnt, bevor etwas berechnet wird. Denoise und Sharpen sind getrennte Anfragen, verketten Sie sie also, wenn ein Bild beides braucht. Schärfen rekonstruiert Details, prüfen Sie Gesichter und Schrift daher in voller Größe.
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": "topaz/denoise-sharpen/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "denoise_normal"
}
}'
# 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.
