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 di integrazione per la conversione del genere facciale, che può generare un’immagine di conversione del genere facciale basata su un’immagine di un volto caricata dall’utente, utilizzando algoritmi di editing e generazione facciale. La conversione da uomo a donna può includere effetti di bellezza, trucco leggero, frangia e capelli lunghi; la conversione da donna a uomo può includere l’aggiunta di baffi e capelli corti.

​
Processo di richiesta

Per utilizzare l’API, è necessario prima richiedere il servizio corrispondente sulla pagina API di conversione del genere facciale. 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 verrà riportati automaticamente alla pagina corrente. Alla prima richiesta, verrà offerto un credito gratuito, che consente di utilizzare l’API senza costi.

​
Utilizzo di base

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

Inoltre, è necessario caricare le informazioni sul genere del volto tramite il parametro gender_infos, che è un array e può contenere più informazioni. Possiamo quindi compilare i contenuti corrispondenti nell’interfaccia, come mostrato nell’immagine:

Possiamo vedere che qui abbiamo impostato le intestazioni della richiesta, che includono:
  • 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.
  • gender_infos: informazioni sul genere e sulla regione del volto, dove il genere è un parametro obbligatorio, 0 indica la conversione da maschio a femmina, 1 indica la conversione da femmina a maschio.
Dopo aver effettuato la selezione, possiamo 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 abbiamo ottenuto il seguente risultato: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}
Possiamo vedere che nel risultato restituito c’è un campo image_url, che è l’immagine del volto modificata in base ai parametri di cambiamento di genere forniti. Le informazioni sul volto dopo la modifica sono mostrate qui sotto:

Possiamo vedere che il volto nell’immagine è cambiato in base al genere fornito. 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-gender' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.xhuoapi.ai/lrbtcn.jpg",
  "gender_infos": [{"gender":1}]
}'
Il codice di integrazione in Python è il seguente: 
import requests

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

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

payload = {
    "image_url": "https://cdn.xhuoapi.ai/lrbtcn.jpg",
    "gender_infos": [{"gender":1}]
}

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 conversione del genere facciale per generare un’immagine di conversione del genere facciale basata su un’immagine di un volto caricata dall’utente, utilizzando algoritmi di editing e generazione facciale. Speriamo che questo documento possa aiutarti a integrare e utilizzare meglio l’API. Se hai domande, non esitare a contattare il nostro team di supporto tecnico.