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 un’API per il cambiamento dell’età del volto, che può modificare l’età del volto in un’immagine fornita in base all’immagine e all’età inserite. L’uso generale prevede che l’utente carichi un’immagine del volto e, basandosi su algoritmi di editing e generazione del volto, venga restituita un’immagine del volto invecchiato o ringiovanito, supportando la variazione dell’età del volto.

​
Procedura di richiesta

Per utilizzare l’API, è necessario prima richiedere il servizio corrispondente sulla pagina dell’API di cambiamento dell’età del volto. Una volta 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 verrà riportati automaticamente alla pagina corrente. Alla prima richiesta, verrà fornito un credito gratuito, che consente di utilizzare l’API senza costi.

​
Uso di base

Per prima cosa, è necessario comprendere il modo di utilizzo di base, che consiste nell’inserire il link dell’immagine e le informazioni sull’età per ottenere l’immagine elaborata. È necessario semplicemente passare un campo image_url, l’immagine del volto è mostrata nell’immagine sottostante:

Inoltre, è necessario caricare le informazioni sull’età del volto tramite il parametro age_infos, che è un array e consente di inserire più informazioni. 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.
  • age_infos: informazioni sull’età e sulla regione del volto, dove l’età è un parametro obbligatorio.
Dopo aver effettuato le selezioni, 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/ft/ChangeAgePic/1256437459/bfce1ab8-5fd7-464d-8878-b38433f84d0e"
}
Si può notare che nel risultato restituito c’è un campo image_url, che rappresenta l’immagine del volto modificata in base all’età inserita. L’immagine del volto modificato è mostrata di seguito:

Si può osservare che il volto nell’immagine è cambiato in base all’età inserita. 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/change-age' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "age_infos": [{"age":60}],
  "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}'
Il codice di integrazione in Python è il seguente: 
import requests

url = "https://api.xhuoapi.ai/v1/face/change-age"

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

payload = {
    "age_infos": [{"age":60}],
    "image_url": "https://cdn.xhuoapi.ai/f5687u.png"
}

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, si è 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, avete appreso come utilizzare l’API per il cambiamento dell’età del volto in base all’immagine e alle informazioni sull’età fornite. Speriamo che questo documento possa aiutarvi a integrare e utilizzare meglio l’API. Se avete domande, non esitate a contattare il nostro team di supporto tecnico.