Wprowadzenie
Powiększanie w Gigapixelu
W Gigapixelu dostępne są powiększanie precyzyjne i rekonstrukcja generatywna. Bez wskazania modelu używany jest standard_v2.
Przygotuj żądanie
Wyślij image_url i wybierz resolution: 2k, 4k lub 8k, domyślnie 4k. Domyślnym formatem jest JPEG.
Ograniczenia wyjścia
Dla przezroczystości połącz preset: transparent z output_format: png, a następnie sprawdź krawędzie.
| Pole | Wartość |
|---|---|
| Wejście | Obraz |
| Wyjście | Obraz |
| Model domyślny |
|
| Poziom domyślny | 4K |
| Wynik | JPEG lub PNG; przezroczystość zawsze w PNG |
| Rozliczenie | Za obraz, według modelu i poziomu |
Najważniejsze funkcje
Więcej pikseli nie wystarczy, by wyostrzyć oczy
Od lewej: źródło, Standard V2 i Wonder 4. W wyniku Standard powiększone jest także rozmycie. W tej próbie Wonder pozwala uzyskać wyraźniejszą twarz z zachowaniem ogólnego podobieństwa.
Sprawdź również rysy twarzy
W wyniku Redefine mężczyzna wygląda młodziej i ma inne rysy. W Recover 3 i Standard MAX również zrekonstruowano detale; w Detail silne rozmycie pozostało bardziej widoczne. To obserwacje dotyczące jednego obrazu.
Powiększ różę z zachowaniem przezroczystego tła
Wyciętą żółtopomarańczową różę powiększono z 400×301 do 2360×1776 pikseli z zachowaniem kanału alfa. Na różowych końcach płatków widać krople wody, a obok krótki fragment zielonej łodygi i liście. Ciemne tło służy wyłącznie prezentacji porównania; w pliku przykładowym pozostawiono przezroczystość.
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Zdjęcie lub grafika JPEG, PNG albo WebP do powiększenia w Gigapixelu. od 1 znaków |
preset | Nie | Dwanaście ustawień: pięć precyzyjnych, sześć generatywnych i |
resolution | Nie |
|
output_format | Nie | Domyślnie zwracany jest |
Cennik
W Gigapixelu naliczana jest opłata za przetworzony obraz zgodnie z preset i resolution. Zmiana output_format nie wpływa na koszt.
| Rozdzielczość | Preset stylu: cgi | Preset stylu: detail | Preset stylu: high_fidelity_v3 | Preset stylu: low_resolution_v2 | Preset stylu: standard_v2 | Preset stylu: text_refine | Preset stylu: transparent | Preset stylu: wonder_3_5 | Preset stylu: wonder_4 | Preset stylu: recover_3 | Preset stylu: redefine | Preset stylu: standard_max |
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.24 / obraz | $0.24 / obraz | $0.24 / obraz |
| $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.12 / obraz | $0.36 / obraz | $0.36 / obraz | $0.60 / obraz | $0.60 / obraz | $0.60 / obraz |
| $0.36 / obraz | $0.36 / obraz | $0.36 / obraz | $0.36 / obraz | $0.36 / obraz | $0.36 / obraz | $0.36 / obraz | $1.08 / obraz | $1.08 / obraz | $2.04 / obraz | $2.04 / obraz | $2.04 / obraz |
Zastosowania
Przygotowanie obrazu do druku
Wybierz rozdzielczość, a przed drukowaniem obejrzyj twarze i drobne wzory.
Powiększanie logo i wyciętych grafik
Wypróbuj text_refine do liter i grafiki albo transparent, gdy w pliku PNG ma pozostać przezroczyste tło.
Wskazówki
Podaj źródło
Wskaż zdjęcie lub grafikę JPEG, PNG albo WebP w
image_url.Wybierz sposób rekonstrukcji
Zacznij od
standard_v2, aby zachować treść, lub wybierzwonder_4, gdy potrzebujesz rekonstrukcji detali.Ustaw wynik
Wybierz
resolutioni format; dlatransparentpodajoutput_format: png.
Powiększanie w Gigapixelu
Wybrany model Gigapixel służy do powiększenia zdjęcia lub grafiki do danego poziomu pikseli; obraz przezroczysty jest zwracany jako PNG.
Przygotuj żądanie
{
"image_url": "https://example.com/blurred-portrait.jpg",
"preset": "standard_v2",
"resolution": "2k",
"output_format": "jpeg"
}
Przewodnik po modelach
preset | Zalecane źródło |
|---|---|
standard_v2 | Zwykłe zdjęcia; domyślny model precyzyjny |
high_fidelity_v3 | Już ostre materiały w wysokiej rozdzielczości |
low_resolution_v2 | Małe lub silnie skompresowane obrazy |
cgi | Ilustracje i rendery |
text_refine | Tekst, logo i grafika |
wonder_4 | Najnowsze wszechstronne powiększanie generatywne |
wonder_3_5 | Rekonstrukcja generatywna Wonder 3.5 |
recover_3 | Bardzo zniszczone fotografie |
standard_max | Generatywna rekonstrukcja szczegółów |
redefine | Nowe detale z możliwą zmianą podobieństwa |
detail | Bardziej realistyczna skóra twarzy z AI |
transparent | Powiększanie PNG z alfą |
Zaobserwowane wyniki
Od lewej: źródło, Standard V2 i Wonder 4. W wyniku Standard powiększone jest także rozmycie. W tej próbie Wonder pozwala uzyskać wyraźniejszą twarz z zachowaniem ogólnego podobieństwa.
W wyniku Redefine mężczyzna wygląda młodziej i ma inne rysy. W Recover 3 i Standard MAX również zrekonstruowano detale; w Detail silne rozmycie pozostało bardziej widoczne. To obserwacje dotyczące jednego obrazu.
Wyciętą żółtopomarańczową różę powiększono z 400×301 do 2360×1776 pikseli z zachowaniem kanału alfa. Na różowych końcach płatków widać krople wody, a obok krótki fragment zielonej łodygi i liście. Ciemne tło służy wyłącznie prezentacji porównania; w pliku przykładowym pozostawiono przezroczystość.
Ograniczenia wyjścia
W jednym żądaniu przetwarzany jest jeden obraz jednym modelem. W trybach generatywnych mogą zmienić się twarze i detale, dlatego nie nadają się one do rekonstrukcji dowodowej ani dokumentów tożsamości. Pliki 8K mogą być duże. Połączenie transparent z JPEG jest odrzucane.
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/gigapixel/upscale",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg",
"preset": "standard_v2",
"resolution": "4k"
}
}'
# 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.
