Skip to main content
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:
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:
Il codice di integrazione in Python è il seguente:

​
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

​
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.