Przejdź do głównej treści
W niniejszym dokumencie przedstawiono sposób integracji API do upiększania twarzy, które może precyzyjnie zlokalizować rysy twarzy na podstawie przesłanego przez użytkownika zdjęcia twarzy (można przetworzyć maksymalnie pięć twarzy na jednym zdjęciu), realizując funkcje takie jak wygładzanie skóry, rozjaśnianie cery, usuwanie trądziku i inne.

​
Proces aplikacji

Aby skorzystać z API, należy najpierw przejść na stronę API do upiększania twarzy i złożyć wniosek o odpowiednią usługę. Po wejściu na stronę, kliknij przycisk „Acquire”, jak pokazano na poniższym obrazku: Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować. Po zalogowaniu lub rejestracji automatycznie wrócisz na bieżącą stronę. Podczas pierwszej aplikacji otrzymasz darmowy limit, który pozwala na bezpłatne korzystanie z tego API.

​
Podstawowe użycie

Najpierw zapoznaj się z podstawowym sposobem użycia, polegającym na wprowadzeniu linku do zdjęcia oraz informacji o upiększaniu, aby uzyskać przetworzone zdjęcie. Najpierw musisz przekazać prosty parametr image_url, zdjęcie twarzy przedstawione na poniższym obrazku:

Następnie musimy przesłać parametry dotyczące informacji o upiększaniu twarzy, szczegóły znajdują się w poniższej informacji o ciele żądania. Następnie możemy wypełnić odpowiednie treści na interfejsie, jak pokazano na poniższym obrazku:

Możemy zauważyć, że ustawiliśmy nagłówki żądania, w tym:
  • accept: format odpowiedzi, który chcemy otrzymać, tutaj wpisujemy application/json, czyli format JSON.
  • authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.
Dodatkowo ustawiliśmy ciało żądania, które obejmuje:
  • image_url: link do zdjęcia twarzy, które ma być przetworzone.
  • smoothing: stopień wygładzania, zakres wartości [0,100]. 0 oznacza brak wygładzania, 100 oznacza najwyższy stopień. Wartość domyślna to 10.
  • whitening: stopień rozjaśnienia, zakres wartości [0,100]. 0 oznacza brak rozjaśnienia, 100 oznacza najwyższy stopień. Wartość domyślna to 30.
  • face_lifting: stopień wyszczuplenia twarzy, zakres wartości [0,100]. 0 oznacza brak wyszczuplenia, 100 oznacza najwyższy stopień. Wartość domyślna to 70.
  • eye_enlarging: stopień powiększenia oczu, zakres wartości [0,100]. 0 oznacza brak powiększenia, 100 oznacza najwyższy stopień. Wartość domyślna to 70.
Po dokonaniu wyboru, można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na poniższym obrazku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, a otrzymamy następujący wynik: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Możemy zauważyć, że w zwróconym wyniku znajduje się pole image_url, które zawiera przetworzone zdjęcie twarzy na podstawie wprowadzonych informacji o upiększaniu. Zmiany w wyglądzie twarzy przedstawione są na poniższym obrazku:

Możemy zauważyć, że twarz na zdjęciu zmieniła się zgodnie z wprowadzonymi informacjami o upiększaniu. Dodatkowo, jeśli chcesz wygenerować odpowiedni kod do integracji, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco: 
curl -X POST 'https://api.acedata.cloud/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
Kod do integracji w Pythonie wygląda następująco: 
import requests

url = "https://api.acedata.cloud/face/beautify"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "smoothing": 50,
    "whitening": 50,
    "face_lifting": 50,
    "eye_enlarging": 50
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Obsługa błędów

Podczas wywoływania API, jeśli wystąpią błędy, API zwróci odpowiedni kod błędu i informacje. Na przykład:
  • 400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
  • 401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
  • 429 too_many_requests: Zbyt wiele żądań, przekroczono limit.
  • 500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

​
Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API do upiększania twarzy na podstawie przesłanego przez użytkownika zdjęcia twarzy (można przetworzyć maksymalnie pięć twarzy na jednym zdjęciu), precyzyjnie lokalizując rysy twarzy, realizując funkcje takie jak wygładzanie skóry, rozjaśnianie cery, usuwanie trądziku i inne. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, prosimy o kontakt z naszym zespołem wsparcia technicznego.