Wprowadzenie
Co robi ten endpoint
Uruchamia jeden model Topaz Labs na jednym zdjęciu. Presety odszumiania usuwają ziarno, szum wysokiego ISO i plamki kompresji; presety wyostrzania naprawiają miękką ostrość, poruszenie i rozmycie obiektywu. Wyjście ma tę samą szerokość i wysokość co wejście.
Ważne wejścia
image_url przyjmuje JPEG, PNG lub WebP do 24 megapikseli, przesłany albo jako publiczny link. preset wybiera model, domyślnie denoise_normal. output_format to jpeg (domyślnie) lub png.
Co wraca
Jeden obraz na żądanie, udostępniany z magazynu platformy po zakończeniu asynchronicznego zadania. Obrazy powyżej 24 megapikseli są odrzucane przy wysyłce z invalid_request.
| Pole | Wartość |
|---|---|
| Wejście | Obraz |
| Wyjście | Obraz |
| Endpoint | Edycja obrazu |
| Presety | 3 poziomy odszumiania, 8 modeli wyostrzania |
| Prompt | Brak |
| Rozliczenie | Stała cena za obraz |
Najważniejsze funkcje
Zdjęcie z baru przy świecach bez plamek, z nietkniętą twarzą
Zasypaliśmy portret 2048×1152 mocnym szumem kolorowym i przepuściliśmy go przez Denoise Normal. Plamki na swetrze i ciemnych półkach z winem zniknęły, a oczy, kolczyk-koło i światła bokeh zostały na miejscu. Piegi wróciły bledsze niż w czystym oryginale.
Ziarno jak z kliszy usunięte z portretu w kawiarni
WebP 1024×1536 z drobnym szarym ziarnem na skórze, włosach i swetrze z dzianiny przeszedł przez Denoise Strong w około 25 sekund. Ziarno zniknęło, loki zachowały pasma, a sweter splot; skóra wyszła nieco gładsza.
Sharpen Standard przywraca ostrość miękkiej twarzy
Portret, który celowo rozmyliśmy, po 14 sekundach znów miał czytelne oczy, brwi i kilkudniowy zarost. Takie detale model rekonstruuje, więc sprawdź wynik w pełnym rozmiarze, zanim zaczniesz na nim polegać.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Zdjęcie do oczyszczenia: JPEG, PNG lub WebP jako przesłany plik albo publiczny link, maksymalnie 24 megapiksele (6000×4000 się mieści). od 1 znaków |
preset | Nie | Który model Topaz zostanie uruchomiony. |
output_format | Nie | jpeg (domyślnie) lub png. png pozwala uniknąć kolejnej stratnej kompresji, ale daje większy plik. |
Cennik
$0.12 / obraz
Każdy gotowy obraz kosztuje tę samą stałą kwotę niezależnie od wybranego presetu spośród jedenastu i formatu wyjściowego spośród dwóch; nieudane lub odrzucone żądanie nic nie kosztuje.
Zastosowania
Zdjęcia z telefonu nocą i we wnętrzach
Zdjęcia z wysokim ISO z koncertu, restauracji czy ciemnego salonu robią się plamiste. Zacznij od Denoise Normal i przejdź na Strong, jeśli w cieniach dalej widać plamki.
Ziarno na obrazach generowanych przez AI
Niektóre modele graficzne zostawiają drobne ziarno lub powtarzalną fakturę na skórze i gładkim tle. Jedno przejście Denoise daje czystszą bazę przed powiększeniem, kadrowaniem czy drukiem.
Ujęcia prawie ostre
Lekko chybiona ostrość, trochę poruszenia albo miękki obiektyw. Sharpen Standard radzi sobie z łagodnymi przypadkami, Motion Blur i Lens Blur celują w te dwa problemy, a Portrait i Wildlife są dostrojone do skóry i sierści.
Wskazówki
Sprawdź rozmiar
Wyślij JPEG, PNG lub WebP do 24 megapikseli jako przesłany plik albo publiczny link. Większe pliki są odrzucane przy wysyłce, więc najpierw je zmniejsz.
Wybierz jeden preset
Użyj presetu denoise_, gdy problemem jest ziarno lub plamki, a presetu sharpen_, gdy rozmycie. Każde żądanie uruchamia jeden preset; jeśli potrzebujesz obu, najpierw odszum, a potem wyślij ten wynik do Sharpen.
Odpytaj i porównaj
Utwórz zadanie, odpytuj je do zakończenia i pobierz plik z magazynu platformy. Porównaj go ze źródłem przy 100% powiększenia w okolicy oczu, włosów i drobnych faktur.
Wprowadzenie
Topaz Denoise & Sharpen udostępnia dwie rodziny modeli Topaz Labs przez jeden endpoint. Denoise usuwa szum i ziarno, starając się zachować prawdziwy detal; Sharpen przywraca wyrazistość utraconą przez błąd ostrości, ruch lub miękki obiektyw. Model wybiera się parametrem preset; promptu nie ma.
Żądanie
{
"image_url": "https://example.com/night-shot.jpg",
"preset": "denoise_normal",
"output_format": "jpeg"
}
Presety
| preset | Zastosowanie |
|---|---|
denoise_normal | Codzienny szum ze słabego światła lub kompresji (domyślny) |
denoise_strong | Bardzo ciemne zdjęcia lub wysokie ISO; zachowuje więcej detalu niż Extreme |
denoise_extreme | Mocno zniszczone lub silnie skompresowane obrazy |
sharpen_standard | Lekka miękkość lub drobne poruszenie; zwykły punkt wyjścia |
sharpen_strong | Wyraźnie chybiona ostrość |
sharpen_natural | Umiarkowane wyostrzanie, które szanuje naturalne faktury |
sharpen_portrait | Twarze i skóra |
sharpen_wildlife | Sierść, pióra i inne detale przyrody |
sharpen_refocus | Drobny detal w lekko nieostrym obrazie |
sharpen_motion_blur | Rozmycie od ruchu aparatu lub obiektu |
sharpen_lens_blur | Nieostrość i miękkość obiektywu |
Nasze testy
Portret przy świecach 2048×1152 z mocno dodanym szumem kolorowym wrócił czysty po około 19 sekundach na denoise_normal; oczy, kolczyki i światła bokeh przetrwały, piegi zbladły. Portret z kawiarni 1024×1536 z drobnym ziarnem, wysłany jako WebP, stracił ziarno na denoise_strong w około 25 sekund, a loki i splot swetra zostały. Celowo rozmyty portret 1100×900 odzyskał oczy i zarost na sharpen_standard w 14 sekund. Wszystkie trzy wróciły w rozmiarze wejścia.
Ograniczenia
Wejście jest ograniczone do 24 megapikseli (6000×4000 się mieści); większe obrazy są odrzucane, zanim cokolwiek zostanie naliczone. Denoise i Sharpen to osobne żądania, więc połącz je w łańcuch, jeśli obraz potrzebuje obu. Wyostrzanie rekonstruuje detal, dlatego twarze i tekst sprawdzaj w pełnym rozmiarze.
Szybki start z API
# 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"
Uwierzytelnianie, pełny schemat, odpytywanie i obsługę błędów opisuje dokumentacja API.
