Vai al contenuto principale
Questo documento introduce una guida per l’integrazione dell’API di bellezza del volto, che può elaborare un’immagine del volto caricata dall’utente (in grado di gestire fino a cinque volti in un’unica immagine), localizzando con precisione i tratti del viso e realizzando funzioni di bellezza come la levigatura della pelle, l’illuminazione della pelle e la rimozione dell’acne.

​
Procedura di richiesta

Per utilizzare l’API, è necessario prima richiedere il servizio corrispondente sulla pagina API di bellezza del volto. Dopo essere entrati nella pagina, cliccare sul pulsante “Acquire”, come mostrato nell’immagine: Se non si è ancora effettuato il login o la registrazione, si verrà automaticamente reindirizzati alla pagina di login per registrarsi e accedere. Dopo aver effettuato il login o la registrazione, si tornerà automaticamente alla pagina corrente. Alla prima richiesta, verrà fornito un credito gratuito, che consente di utilizzare l’API senza costi.

​
Utilizzo di base

Innanzitutto, è importante comprendere il modo di utilizzo di base, che consiste nell’inserire il link dell’immagine e le informazioni di bellezza, per ottenere l’immagine elaborata. È necessario semplicemente trasmettere un campo image_url, l’immagine del volto è mostrata nell’immagine sottostante:

Dopodiché, è necessario caricare i parametri delle informazioni di bellezza del volto, come indicato nelle informazioni del corpo della richiesta qui sotto. Possiamo quindi compilare i contenuti corrispondenti nell’interfaccia, come mostrato nell’immagine:

Si può notare che qui abbiamo impostato le intestazioni della richiesta, tra cui:
  • accept: il formato della risposta desiderata, qui impostato su application/json, ovvero formato JSON.
  • authorization: la chiave per chiamare l’API, che può essere selezionata direttamente dopo la richiesta.
Inoltre, abbiamo impostato il corpo della richiesta, che include:
  • image_url: il link dell’immagine del volto da elaborare.
  • smoothing: livello di levigatura, intervallo di valori [0,100]. 0 significa nessuna levigatura, 100 rappresenta il massimo livello. Valore predefinito 10.
  • whitening: livello di schiarimento, intervallo di valori [0,100]. 0 significa nessun schiarimento, 100 rappresenta il massimo livello. Valore predefinito 30.
  • face_lifting: livello di snellimento del viso, intervallo di valori [0,100]. 0 significa nessuno snellimento, 100 rappresenta il massimo livello. Valore predefinito 70.
  • eye_enlarging: livello di ingrandimento degli occhi, intervallo di valori [0,100]. 0 significa nessun ingrandimento, 100 rappresenta il massimo livello. Valore predefinito 70.
Dopo aver effettuato le scelte, si può notare che a destra è stato generato il codice corrispondente, come mostrato nell’immagine:

Cliccando sul pulsante “Try” è possibile effettuare un test, come mostrato nell’immagine sopra, e si ottiene il seguente risultato: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Si può notare che nel risultato restituito c’è un campo image_url, che rappresenta l’immagine del volto dopo le modifiche di bellezza in base all’input. Le informazioni sul volto modificate sono mostrate nell’immagine sottostante:

Si può notare che il volto nell’immagine è cambiato in base alle informazioni di bellezza fornite. Inoltre, se si desidera generare il codice di integrazione corrispondente, è possibile copiarlo direttamente, ad esempio il codice CURL è il seguente: 
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
}'
Il codice di integrazione in Python è il seguente: 
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)

​
Gestione degli errori

Quando si chiama l’API, se si verifica un errore, l’API restituirà il codice di errore e le informazioni corrispondenti. Ad esempio:
  • 400 token_mismatched: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 400 api_not_implemented: Richiesta non valida, probabilmente a causa di parametri mancanti o non validi.
  • 401 invalid_token: Non autorizzato, token di autorizzazione non valido o mancante.
  • 429 too_many_requests: Troppe richieste, hai superato il limite di frequenza.
  • 500 api_error: Errore interno del server, qualcosa è andato storto sul server.

​
Esempio di risposta di errore

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

​
Conclusione

Attraverso questo documento, hai appreso come utilizzare l’API di bellezza del volto per elaborare un’immagine del volto caricata dall’utente (in grado di gestire fino a cinque volti in un’unica immagine), localizzando con precisione i tratti del viso e realizzando funzioni di bellezza come la levigatura della pelle, l’illuminazione della pelle e la rimozione dell’acne. Speriamo che questo documento ti aiuti a integrare e utilizzare meglio l’API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.