Topaz API
Topaz API w WaveSpeedAI — modele poprawy obrazu Topaz Labs jako endpointy REST: Sharpen usuwa rozmycie obiektywu i ruchu, Denoise — ziarno i szum przy wysokim ISO, Restore — kurz i rysy na starych zdjęciach, a Lighting poprawia ekspozycję, balans bieli i kolory.
Wyślij plik JPEG lub PNG i odbierz poprawiony obraz: wyostrz nieostre lub rozmyte ujęcia, oczyść zaszumione zdjęcia ze słabego oświetlenia, usuń kurz i rysy ze skanów odbitek albo skoryguj ekspozycję i temperaturę barwową. Każdy endpoint przyjmuje obraz, wybór modelu i format wyjściowy, w tym samym przepływie predykcji REST co każdy inny model w WaveSpeedAI.
/filters:quality(82)/examples/f1eed2a7bfe888eb867d726036d8a338/1783683950126693744_2rEOX7gp.webp)
Przegląd
O modelu Topaz API
Co robi Topaz, jakie miejsce zajmuje w linii modeli Topaz Labs i dlaczego zespoły po niego sięgają.
Topaz to model skalowania AI od Topaz Labs, dostępny przez REST API WaveSpeedAI. Topaz API w WaveSpeedAI — modele poprawy obrazu Topaz Labs jako endpointy REST: Sharpen usuwa rozmycie obiektywu i ruchu, Denoise — ziarno i szum przy wysokim ISO, Restore — kurz i rysy na starych zdjęciach, a Lighting poprawia ekspozycję, balans bieli i kolory.
Wyślij plik JPEG lub PNG i odbierz poprawiony obraz: wyostrz nieostre lub rozmyte ujęcia, oczyść zaszumione zdjęcia ze słabego oświetlenia, usuń kurz i rysy ze skanów odbitek albo skoryguj ekspozycję i temperaturę barwową. Każdy endpoint przyjmuje obraz, wybór modelu i format wyjściowy, w tym samym przepływie predykcji REST co każdy inny model w WaveSpeedAI.
Rodzina Topaz w WaveSpeedAI zawiera 17 endpointów REST obejmujące workflowy: Video-Tools, Upscale-Video, Upscale-Image, Image-Tools. Każdy wariant ma własny cennik, parametry i przykładowe wyniki — wybierz ten, który pasuje do Twoich danych wejściowych i wymagań produkcyjnych, albo wywołuj kilka z jednego klucza API, aby składać wieloetapowe pipeline'y.
Uruchamiaj Topaz z tym samym kluczem API, kontem rozliczeniowym i limitami, których używasz dla ponad 1000 innych modeli AI w WaveSpeedAI. Bez osobnej konfiguracji u dostawcy, bez osobnych SDK, bez osobnych limitów — jedna integracja obejmuje wszystko: od tekstu na obraz i tekstu na wideo, przez syntezę dźwięku i generowanie 3D, po upscaling i edycję.
Specyfikacja
Możliwości i status premiery Topaz API
Szczegóły modelu, których deweloperzy szukają przed wyborem API: dostępność, oczekiwana długość wyniku, obsługa referencji i aktualne rozwiązanie zastępcze.
Endpointy
Sharpen, Denoise, Restore, Lighting
Cztery endpointy obrazu w topaz/image/, każdy skupiony na jednym rodzaju poprawki, dzięki czemu potok może uruchamiać tylko te kroki, których obraz potrzebuje.
Wejście
JPEG lub PNG
Każdy endpoint przyjmuje pojedynczy obraz jako URL lub plik, bez promptu do napisania.
Wybór modelu
Dla każdego endpointu
Parametr model wybiera wariant: style wyostrzania dla rozmycia obiektywu, rozmycia ruchu, ponownego ustawiania ostrości, portretów i zwierząt dzikich; redukcja szumu Normal, Strong lub Extreme; korekta oświetlenia, balans bieli lub koloryzacja.
Formaty wyjściowe
JPEG, PNG
Domyślnie JPEG; ustaw output_format na png, aby uzyskać wynik bezstratny.
Endpointy
Wszystkie endpointy API Topaz
17 endpointów Topaz dostępnych teraz w WaveSpeedAI — wybierz wariant pasujący do Twojego workflow.
Video Deblur
Topaz Video Motion Deblur removes motion blur from fast-moving footage with Topaz Themis. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Hdr
Topaz Video SDR to HDR converts SDR video to 10-bit HDR with Topaz Hyperion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Frame Interpolation
Topaz Video Frame Interpolation raises frame rates and creates smooth slow motion with Topaz Apollo, Chronos and Aion. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Denoise
Topaz Video Denoise removes noise and grain from video while keeping natural texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Creative
Topaz Video Upscale Creative creatively upscales AI-generated video with Topaz Astra, inventing new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale Generative
Topaz Video Upscale Generative restores and upscales real and AI-generated video with Topaz Starlight diffusion models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Video Upscale
Topaz Video Upscale upscales and enhances video up to 4K with Topaz's precision Proteus, Artemis, Gaia, Theia, Iris and Dione models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Transparent Upscale
Topaz Transparent Image Upscale upscales transparent PNG images while keeping the alpha channel intact. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Creative
Topaz Image Upscale Creative creatively upscales AI-generated images with Topaz Bloom, adding new detail. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale Generative
Topaz Image Upscale Generative upscales and repairs images with Topaz's generative Wonder, Recover and Redefine models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Upscale
Topaz Image Upscale enlarges photos to 2K, 4K or 8K with precise, non-generative Topaz upscaling models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Denoise Generative
Topaz Image Denoise Max removes heavy noise and recovers lost detail with the generative Denoise Max model. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Image Sharpen Generative
Topaz Image Sharpen Generative rebuilds detail in severely blurred images with generative Super Focus models. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112327_sqr1uegu.webp)
Image Sharpen
Topaz Image Sharpen sharpens soft, out-of-focus and motion-blurred photos while keeping them natural. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112312_o76ialis.webp)
Image Restore
Topaz Image Restore cleans dust, scratches and blemishes from scans and old photos. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112304_igpft99n.webp)
Image Lighting
Topaz Image Lighting fixes exposure and white balance, colorizes black-and-white photos and converts to HDR. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
/filters:quality(82)/media/images/20260408112318_eykl2kyy.webp)
Image Denoise
Topaz Image Denoise removes grain and high-ISO noise while preserving detail and texture. Ready-to-use REST inference API, best performance, no coldstarts, affordable pricing.
Przykłady
Topaz w akcji
Prawdziwe wyniki wygenerowane przez API Topaz. Najedź na wideo, aby zobaczyć podgląd, kliknij, aby otworzyć pełnowymiarowy podgląd.
Jak zacząć
Jak korzystać z API Topaz
Cztery kroki od rejestracji do gotowego wyniku. Pełne przykłady w Pythonie, Node.js i cURL znajdziesz w sekcji API poniżej.
- 01
Uzyskaj klucz API
Załóż konto WaveSpeedAI i skopiuj klucz API z panelu. Nowe konta otrzymują darmowe kredyty na start — wystarczy na kilkadziesiąt uruchomień w playground, zanim zaczną się opłaty.
- 02
Wyślij predykcję
Wyślij dane wejściowe jako JSON metodą POST na https://api.wavespeed.ai/api/v3/topaz/image/sharpen. Endpoint od razu zwraca identyfikator predykcji — generowanie jest asynchroniczne, więc nie trzymasz otwartego połączenia na czas inferencji.
- 03
Sprawdzaj ukończenie
Wywołaj GET https://api.wavespeed.ai/api/v3/predictions/{request_id}/result. Przy statusie completed odbierz wyniki; przy failed, cancelled, timeout lub deleted zakończ z błędem; przy każdym innym statusie odpytuj dalej.
- 04
Odczytaj adres wyniku
Gdy status to "completed", odczytaj adres URL z data.outputs[0]. Wskazuje on wygenerowane media w CDN WaveSpeedAI — obraz, wideo, dźwięk lub plik 3D, zależnie od wywołanego wariantu Topaz.
Zastosowania
Co możesz zbudować z Topaz
Typowe workflowy, do których deweloperzy i twórcy używają API Topaz.
Usuwanie rozmycia obiektywu i ruchu
topaz/image/sharpen przywraca wyraźne detale w nieostrych i rozmytych zdjęciach, z wariantami dla rozmycia obiektywu, rozmycia ruchu, ponownego ustawiania ostrości i naturalnie wyglądającej ostrości.
Portrety i zwierzęta dzikie
Endpoint sharpen ma warianty dostrojone do portretów i do zwierząt dzikich, dzięki czemu twarze, sierść i pióra zyskują detale bez halo.
Czyszczenie zdjęć ze słabego światła i wysokiego ISO
topaz/image/denoise usuwa ziarno i szum wysokiego ISO, zachowując detale, z mocami Normal, Strong i Extreme — od lekko po mocno zniszczone obrazy.
Renowacja starych i skanowanych zdjęć
topaz/image/restore usuwa kurz, rysy i uszkodzenia ze starych odbitek i skanów kliszy — do rodzinnych archiwów i projektów digitalizacji.
Korekta ekspozycji, balansu bieli i kolorów
topaz/image/lighting wyrównuje zdjęcia zrobione w słabym świetle, koryguje temperaturę barwową i potrafi dodać naturalne kolory czarno-białym fotografiom.
Wsadowe porządkowanie katalogów i plików użytkowników
Przepuszczaj zdjęcia ofert, nieruchomości lub obrazy przesłane przez użytkowników przez potrzebne endpointy w zautomatyzowanym potoku — bez oprogramowania desktopowego i ręcznej edycji.
Wskazówki
Wskazówki do promptów dla Topaz
Praktyczne rady, jak uzyskiwać lepsze wyniki z Topaz — oparte na wzorcach, które sprawdzają się w produkcyjnych pipeline'ach dla modeli upscalingu.
- 01
Najpierw usuń szum, potem wyostrzaj
Gdy zdjęcie jest zarówno zaszumione, jak i nieostre, uruchom najpierw Denoise, a potem Sharpen. Wyostrzanie zaszumionego obrazu wzmacnia ziarno razem z detalami.
- 02
Dobierz wariant sharpen do rodzaju rozmycia
Dla nieostrych ujęć użyj wariantów lens blur lub refocus, dla drgań aparatu lub poruszonych obiektów — wariantu motion blur, a gdy tematem są twarze lub zwierzęta — wariantów portrait lub wildlife.
- 03
Zacznij od najłagodniejszej mocy
Najpierw wypróbuj redukcję szumu Normal i przejdź do Strong lub Extreme tylko wtedy, gdy ziarno nadal jest widoczne; mocniejsze ustawienia wygładzają drobną teksturę.
- 04
Zostań przy PNG w wieloetapowych potokach
Ustaw output_format na png, gdy wynik trafia do kolejnego kroku, np. skalowania lub drugiej poprawki, aby każdy przebieg nie dokładał kompresji JPEG.
Cennik
Cennik API Topaz
Cena jest naliczana za wynik. Końcowa opłata zależy od parametrów ustawionych w playground każdego wariantu (rozdzielczość, czas trwania, liczba wyników, referencje).
| Endpoint | Typ | Cena początkowa |
|---|---|---|
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | video-tools | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-video | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | upscale-image | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
| topaz/ | image-tools | $0.10 |
API
Wywołaj API Topaz
Uzyskaj klucz API na wavespeed.ai/accesskey, a następnie wyślij predykcję przez REST. Playground generuje gotowe do wklejenia przykłady dla dowolnej kombinacji danych wejściowych.
POSThttps://api.wavespeed.ai/api/v3/topaz/image/sharpen
# 1. Submit the prediction.
SUBMIT_RESPONSE=$(curl --silent --show-error --fail-with-body \
-X POST "https://api.wavespeed.ai/api/v3/topaz/image/sharpen" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $WAVESPEED_API_KEY" \
-d '{
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}')
TASK=$(printf '%s' "$SUBMIT_RESPONSE" | jq 'if has("data") then .data else . end')
PREDICTION_ID=$(printf '%s' "$TASK" | jq -r '.id')
if [ -z "$PREDICTION_ID" ] || [ "$PREDICTION_ID" = "null" ]; then
printf 'Submission response did not contain a prediction id
' >&2
exit 1
fi
RESULT_URL="https://api.wavespeed.ai/api/v3/predictions/$PREDICTION_ID/result"
# 2. Poll until the prediction finishes.
while true; do
RESPONSE=$(curl --silent --show-error --fail-with-body "$RESULT_URL" \
-H "Authorization: Bearer $WAVESPEED_API_KEY")
RESULT=$(printf '%s' "$RESPONSE" | jq 'if has("data") then .data else . end')
STATUS=$(printf '%s' "$RESULT" | jq -r '.status')
case "$STATUS" in
completed) printf '%s\n' "$RESULT" | jq '.outputs'; break ;;
failed|cancelled|timeout|deleted) printf '%s\n' "$RESULT" | jq . >&2; exit 1 ;;
*) sleep 2 ;;
esac
doneconst submitUrl = "https://api.wavespeed.ai/api/v3/topaz/image/sharpen";
const apiKey = process.env.WAVESPEED_API_KEY;
if (!apiKey) throw new Error('Set WAVESPEED_API_KEY');
async function requestJson(url, options = {}) {
const response = await fetch(url, options);
if (!response.ok) throw new Error(await response.text());
return response.json();
}
// 1. Submit the prediction.
const body = await requestJson(submitUrl, {
method: "POST",
headers: {
"Authorization": `Bearer ${apiKey}`,
"Content-Type": "application/json",
},
body: JSON.stringify({
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}),
});
const task = body.data ?? body;
const resultUrl = `https://api.wavespeed.ai/api/v3/predictions/${task.id}/result`;
// 2. Poll until the prediction finishes.
while (true) {
const resultBody = await requestJson(resultUrl, {
headers: { "Authorization": `Bearer ${apiKey}` },
});
const result = resultBody.data ?? resultBody;
if (result.status === "completed") {
console.log(result.outputs);
break;
}
if (["failed", "cancelled", "timeout", "deleted"].includes(result.status)) throw new Error(JSON.stringify(result));
await new Promise(resolve => setTimeout(resolve, 2000));
}import json
import os
import time
from urllib.request import Request, urlopen
api_key = os.environ["WAVESPEED_API_KEY"]
headers = {"Authorization": f"Bearer {api_key}", "Content-Type": "application/json"}
payload = {
"image": "https://interactive-examples.mdn.mozilla.net/media/cc0-images/painted-hand-298-332.jpg",
"model": "Standard",
"output_format": "jpeg"
}
def request_json(url, data=None):
request = Request(url, data=data, headers=headers, method="POST" if data else "GET")
with urlopen(request) as response:
return json.load(response)
# 1. Submit the prediction.
body = request_json("https://api.wavespeed.ai/api/v3/topaz/image/sharpen", json.dumps(payload).encode())
task = body.get("data", body)
result_url = f"https://api.wavespeed.ai/api/v3/predictions/{task['id']}/result"
# 2. Poll until the prediction finishes.
while True:
result_body = request_json(result_url)
result = result_body.get("data", result_body)
status = result.get("status")
if status == "completed":
print(result.get("outputs", []))
break
if status in {"failed", "cancelled", "timeout", "deleted"}:
raise RuntimeError(result)
time.sleep(2)Porównanie
Topaz a alternatywy
Kiedy wybrać Topaz zamiast podobnych modeli w WaveSpeedAI.
Topaz a Topaz Photo AI (desktop)
Topaz Photo AI to aplikacja desktopowa działająca na Twoim komputerze. Endpointy Topaz API działają w chmurze i są wywoływane przez REST, co sprawdza się w serwerach, zadaniach wsadowych i aplikacjach przetwarzających obrazy własnych użytkowników.
Topaz a Image Upscaler Collection
Kolekcja Image Upscaler służy do zwiększania rozdzielczości. Endpointy Topaz naprawiają sam obraz: rozmycie, szum, uszkodzenia i oświetlenie, i często uruchamia się je przed skalowaniem lub razem z nim.
Topaz a Self-hosted open-source models
Modele open source do odszumiania i renowacji wymagają własnych GPU i utrzymania. Endpointy Topaz są hostowane, rozliczane za obraz i korzystają z jednego klucza API i konta rozliczeniowego z każdym innym modelem w WaveSpeedAI.
FAQ
Topaz API — najczęściej zadawane pytania
Cennik, licencja, integracja — typowe pytania o uruchamianie Topaz w WaveSpeedAI.
Które modele Topaz są dostępne w WaveSpeedAI?
Dostępne są endpointy obrazu Topaz: Sharpen, Denoise, Restore i Lighting. Wszystkie aktywne endpointy Topaz znajdziesz w tabeli na tej stronie wraz z aktualną ceną.
Czy potrzebuję promptu?
Nie. Wyślij obraz, w razie potrzeby wybierz inny wariant modelu niż domyślny i wskaż format wyjściowy JPEG lub PNG.
Jak wyceniane są endpointy Topaz?
Za obraz, według ceny podanej na stronie każdego modelu i w tabeli cen powyżej. WaveSpeedAI działa w modelu pay as you go: bez subskrypcji, a środki nigdy nie wygasają.
Czym jest API Topaz?
Topaz to model upscaler od Topaz Labs, udostępniony jako REST API w WaveSpeedAI. Topaz API w WaveSpeedAI — modele poprawy obrazu Topaz Labs jako endpointy REST: Sharpen usuwa rozmycie obiektywu i ruchu, Denoise — ziarno i szum przy wysokim ISO, Restore — kurz i rysy na starych zdjęciach, a Lighting poprawia ekspozycję, balans bieli i kolory. Możesz wywoływać go programowo lub wypróbować w playground, do którego prowadzi link powyżej.
Jak wywołać API Topaz?
Załóż konto WaveSpeedAI, skopiuj klucz API z /accesskey, a następnie wyślij POST na https://api.wavespeed.ai/api/v3/topaz/image/sharpen z danymi wejściowymi w JSON. Endpoint zwraca identyfikator predykcji. Odpytuj endpoint wyniku mniej więcej co 2 sekundy, wydłużaj odstęp przy długich zadaniach i zatrzymaj się przy dowolnym statusie końcowym. Produkcyjne przykłady w Pythonie / Node.js / cURL znajdziesz powyżej.
Ile kosztuje API Topaz?
Topaz zaczyna się od $0.10. Dokładny koszt zależy od ustawionych parametrów (rozdzielczość, czas trwania, liczba wyników, referencje). Podgląd kosztu na żywo obok przycisku Generuj w playground pokazuje dokładną cenę dla bieżących danych.
Jakie warianty Topaz są dostępne?
WaveSpeedAI udostępnia 17 aktywnych endpointów Topaz: topaz/video/deblur, topaz/video/hdr, topaz/video/frame-interpolation, topaz/video/denoise, topaz/video/upscale-creative, topaz/video/upscale-generative, topaz/video/upscale, topaz/image/transparent-upscale, i inne. Każdy wariant ma własną stronę playground i cennik.
Czy mogę używać wyników Topaz komercyjnie?
Prawa do komercyjnego użycia wynikają z licencji modelu Topaz Labs. Większość modeli Topaz Labs zezwala na komercyjne wykorzystanie wyników; skrót licencji znajdziesz na stronie playground każdego modelu, a warunki na poziomie platformy w Warunkach świadczenia usług WaveSpeedAI.
Dlaczego korzystać z Topaz w WaveSpeedAI zamiast bezpośrednio?
Jeden klucz API i jedno konto rozliczeniowe dla Topaz ORAZ ponad 1000 innych modeli AI od innych dostawców. Bez osobnej konfiguracji SDK, bez osobnych limitów, bez przepisywania kodu integracji pod każdego dostawcę. Ceny są zazwyczaj na poziomie bezpośredniego API Topaz Labs lub niższe.
Dostawca
O Topaz Labs
Zespół stojący za Topaz i szerszą linią modeli Topaz Labs w WaveSpeedAI.
Topaz Labs tworzy oprogramowanie do poprawy obrazu i wideo oparte na AI, używane przez fotografów, filmowców i studia, znane z Gigapixel, Photo AI i Video AI. Jego modele skupiają się na odzyskiwaniu prawdziwych detali: wyostrzaniu, redukcji szumu, renowacji i korekcji oświetlenia. W WaveSpeedAI modele Topaz są dostępne jako endpointy REST z jednym kluczem API i rozliczeniem pay as you go.
Zacznij budować z Topaz w WaveSpeedAI
Darmowe kredyty na start po rejestracji. Jeden klucz API do ponad 1000 modeli AI od Topaz Labs i wszystkich innych dostawców.
/filters:quality(82)/examples/286559ad86f57a6240b138da36b60f72/1783683968956150943_aga01QGv.webp)
/filters:quality(82)/examples/0dce57b9a07f37936a242097f113443c/1783683972641647743_9sbjtCLV.webp)
/filters:quality(82)/examples/9fb30afa73b645f4b1a46f1db1b68526/1783683975803917626_0qGwk9YN.webp)
/filters:quality(82)/examples/4dfc9fa5d4e12a7bb42324519d201d3d/1783683978615057281_fGsBKT3c.webp)