Wprowadzenie
Co robi ten endpoint
Przyjmuje jedno zdjęcie i zwraca jego kopię, w której do trzech twarzy, zaczynając od największej, zostaje przywrócona i wyostrzona. Wszystko poza twarzami pozostaje bez zmian, a rozdzielczość się nie zmienia. Nie ma promptu.
Ważne dane wejściowe
image_url to zdjęcie: przesłany plik JPEG, PNG lub WebP albo publiczny adres URL. `Wybierz dla modelu Face Enhancer prawdziwą, wyraźnie widoczną twarz o odpowiedniej wielkości w obrazie; operacja „odtwarzanie szczegółów twarzy na zdjęciu w narzędziu Face Enhancer” korzysta z takich szczegółów bardziej niż z twarzy odległej lub zasłoniętej. Wybierz dla modelu Face Enhancer prawdziwą, wyraźnie widoczną twarz o odpowiedniej wielkości w obrazie; operacja „odtwarzanie szczegółów twarzy na zdjęciu w narzędziu Face Enhancer” korzysta z takich szczegółów bardziej niż z twarzy odległej lub zasłoniętej.
Co dostajesz
Jeden obraz na żądanie, w tej samej rozdzielczości, którą wysłano, udostępniany z magazynu platformy po zakończeniu zadania. Aby uzyskać więcej pikseli, użyj /models/image-upscaler-v1.
| Pole | Wartość |
|---|---|
| Wejście | Obraz |
| Wyjście | Obraz |
| Endpoint | Edycja obrazu |
| Input | Jeden adres URL zdjęcia (JPEG, PNG lub WebP) |
| Output | Jeden obraz w JPEG, PNG lub WebP w rozdzielczości wejściowej |
| Faces | Do trzech, zaczynając od największej |
| Everything else | Zostaje bez zmian |
| Controls | Bez promptu — tylko format pliku |
Parametry żądania
| Parametr | Wymagane | Uwaga |
|---|---|---|
image_url | Tak | Zdjęcie do odnowienia: przesłany plik JPEG, PNG lub WebP albo publiczny link do pliku. od 1 znaków |
output_format | Nie | jpeg (domyślnie), png albo webp. png unika kolejnej stratnej kompresji, ale plik jest większy. |
Cennik
$0.012 / obraz
Rozliczenie za każdy obraz według stałej ceny. Format pliku nie zmienia ceny, a nieudane żądania nie są rozliczane.
Zastosowania
Zdjęcia zmniejszane i kompresowane ponownie
Zdjęcia, które przeszły przez komunikator, media społecznościowe albo kilka zapisań, tracą detal najpierw na twarzy. Przepuść je raz, aby przywrócić oczy, brwi, brodę i teksturę skóry.
Zdjęcia profilowe i zespołowe
Wyczyść lekko miękki portret, zanim trafi do profilu, na stronę zespołu albo do biogramu prelegenta. Kadr, światło i tło zostają takie, jak na zdjęciu.
Przed większym układem
Najpierw oczyść twarze, a potem użyj Image Upscaler pod adresem /models/image-upscaler-v1, jeśli zdjęcie potrzebuje też więcej pikseli do banera lub druku.
Wskazówki
Sprawdź twarze
Wybierz dla modelu Face Enhancer prawdziwą, wyraźnie widoczną twarz o odpowiedniej wielkości w obrazie; operacja „odtwarzanie szczegółów twarzy na zdjęciu w narzędziu Face Enhancer” korzysta z takich szczegółów bardziej niż z twarzy odległej lub zasłoniętej. Mocno zasłonięte, bardzo małe lub silnie rozmyte twarze oraz twarze ilustrowane lub w stylu anime zyskują mniej.
Wyślij
image_urlimage_urlto przesłany plik JPEG, PNG lub WebP albo publiczny adres URL. Dodajoutput_format, jeśli chcesz png lub webp zamiast jpeg.Odpytaj, potem porównaj
Wywołanie jest asynchroniczne: utwórz zadanie, odpytuj aż do zakończenia i pobierz obraz z magazynu platformy. Porównaj go z oryginałem w pełnym rozmiarze, szczególnie w okolicach oczu i skóry.
Wprowadzenie
Face Enhancer przywraca i wyostrza twarze na jednym zdjęciu. Znajduje do trzech twarzy, zaczynając od największej, i odtwarza detale, które odebrała kompresja, zmiana rozmiaru lub rozmycie: oczy, brwi, brodę i teksturę skóry. Wszystko poza twarzami pozostaje bez zmian, a obraz wraca w tej samej rozdzielczości, którą wysłano. Nie ma promptu i nie ma czego dostrajać poza formatem pliku.
Żądanie
{
"image_url": "https://example.com/portrait.jpg",
"output_format": "jpeg"
}
image_url to jedyne wymagane pole. output_format domyślnie ma wartość jpeg; ustaw png albo webp, jeśli wolisz.
Co się zmienia, a co zostaje
Twarze się zmieniają, reszta zdjęcia nie. W naszym teście wzięliśmy portret JPEG 720×404 mężczyzny przy barze i celowo go pogorszyliśmy: zmniejszyliśmy o połowę, powiększyliśmy z powrotem i mocno skompresowaliśmy. Wrócił w rozmiarze 720×404 po około 9 sekundach przetwarzania. Oczy, brwi, broda i tekstura skóry były wyraźnie ostrzejsze, a mężczyzna nadal był rozpoznawalnie tą samą osobą. Skóra wyszła nieco gładsza, niż byłaby na prawdziwym zdjęciu, a półka z butelkami za nim zachowała oryginalne bloki kompresji, bo tło nie jest przetwarzane.
Rozmiar też się nie zmienia. Face Enhancer przywraca twarze w rozdzielczości, którą wysyłasz; jeśli potrzebujesz również więcej pikseli, użyj Image Upscaler (/models/image-upscaler-v1).
Twarze zyskują najbardziej, gdy są prawdziwe, dość duże i wyraźnie widoczne. Model Face Enhancer ma mniej danych do odtworzenia na rysunkach i anime oraz przy małych, zasłoniętych lub silnie rozmytych twarzach, co ogranicza operację „odtwarzanie szczegółów twarzy na zdjęciu w narzędziu Face Enhancer”.
Przebieg zadania
Wywołanie jest asynchroniczne. Utwórz zadanie modelu Face Enhancer dla operacji „odtwarzanie szczegółów twarzy na zdjęciu w narzędziu Face Enhancer”, sprawdzaj jego identyfikator do zakończenia i pobierz gotowy plik z pamięci SpicyAPI. Na żądanie wraca jeden obraz, rozliczany według stałej ceny za obraz; nieudane żądanie nie jest rozliczane.
Wskazówki
- Zacznij od zdjęcia, na którym twarze są dość duże i wyraźnie widoczne. Twarz mająca zaledwie kilkadziesiąt pikseli szerokości ma niewiele do odtworzenia.
- Przywracanych jest do trzech twarzy, zaczynając od największej. Pozostałe zostają bez zmian.
- Użyj
png, jeśli wynik będzie jeszcze edytowany albo ponownie kompresowany: unikniesz kolejnej stratnej kompresji, ale plik będzie większy. Format nie zmienia ceny. - Porównaj wynik z oryginałem w pełnym rozmiarze, szczególnie w okolicach oczu i skóry. Nasz test wyszedł nieco gładszy niż prawdziwe zdjęcie, więc zachowaj plik źródłowy.
- Potrzebujesz więcej pikseli oprócz lepszych twarzy? Uruchom Image Upscaler (
/models/image-upscaler-v1) na zdjęciu.
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": "spicyapi/face-enhancer-v1/edit",
"input": {
"image_url": "https://example.com/reference.png",
"output_format": "jpeg"
}
}'
# 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.
