Vai al contenuto principale

Documentation Index

Fetch the complete documentation index at: https://docs.xhuoapi.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.xhuoapi.ai/v1/face/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.xhuoapi.ai/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.xhuoapi.ai/v1/face/beautify"

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

payload = {
    "image_url": "https://cdn.xhuoapi.ai/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.