> ## 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. # Documentazione per l'integrazione dell'API di bellezza del volto > Face Transformation 集成指南 - XHuoAPI 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](https://api.xhuoapi.ai/documents/29641bfa-8e71-4d63-8b35-7c9e647c18ba). Dopo essere entrati nella pagina, cliccare sul pulsante "Acquire", come mostrato nell'immagine: ![](https://cdn.xhuoapi.ai/q6ytrc.png) 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: ```json theme={null} { "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: ```shell theme={null} 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: ```python theme={null} 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 ```json theme={null} { "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.