Saltar al contenido principal
Este documento presentará una API de conversión de género facial que permite a los usuarios subir una imagen de rostro y, basándose en algoritmos de edición y generación de rostros, producir una imagen de conversión de género facial. La conversión de hombre a mujer puede incluir efectos de embellecimiento, maquillaje ligero, flequillo y cabello largo; la conversión de mujer a hombre puede incluir barba y cabello corto.

​
Proceso de solicitud

Para utilizar la API, primero debe ir a la página correspondiente de la API de conversión de género facial para solicitar el servicio correspondiente. Una vez en la página, haga clic en el botón “Acquire”, como se muestra en la imagen: Si aún no ha iniciado sesión o registrado, será redirigido automáticamente a la página de inicio de sesión que le invita a registrarse e iniciar sesión. Después de iniciar sesión o registrarse, será redirigido automáticamente a la página actual. En la primera solicitud, se le otorgará un crédito gratuito que le permitirá utilizar la API sin costo.

​
Uso básico

Primero, debe comprender la forma básica de uso, que consiste en ingresar el enlace de la imagen y la información de género para obtener la imagen resultante procesada. Primero, necesita pasar un campo image_url, la imagen del rostro se muestra a continuación:

Luego, también necesitamos subir los parámetros de información de género facial gender_infos, que es un arreglo y podemos pasar múltiples informaciones. A continuación, podemos completar el contenido correspondiente en la interfaz, como se muestra en la imagen:

Aquí podemos ver que hemos configurado los encabezados de la solicitud, que incluyen:
  • accept: el formato de respuesta que desea recibir, aquí se establece como application/json, es decir, formato JSON.
  • authorization: la clave para llamar a la API, que puede seleccionarse directamente después de la solicitud.
Además, se configuró el cuerpo de la solicitud, que incluye:
  • image_url: el enlace de la imagen facial que necesita ser procesada.
  • gender_infos: información sobre el género y la región facial, donde el género es un parámetro obligatorio, 0 indica de hombre a mujer, 1 indica de mujer a hombre.
Después de seleccionar, se puede observar que también se generó el código correspondiente a la derecha, como se muestra en la imagen:

Haga clic en el botón “Try” para realizar la prueba, como se muestra en la imagen anterior, aquí obtuvimos el siguiente resultado: 
{
  "image_url": "https://faceeffect-1254418846.cos.ap-guangzhou.myqcloud.com/ft/SwapGenderPic/1256437459/1d85ceb9-6847-41ec-a9fd-7a20ddbd13b6"
}
Se puede ver que en el resultado devuelto hay un campo image_url, que es la imagen facial después de la conversión según los parámetros de cambio de género ingresados. La información de la cara después del cambio se muestra a continuación:

Se puede observar que la cara en la imagen ha cambiado según el género ingresado. Además, si desea generar el código de integración correspondiente, puede copiarlo directamente, por ejemplo, el código de CURL es el siguiente: 
curl -X POST 'https://api.acedata.cloud/face/change-gender' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "gender_infos": [{"gender":1}]
}'
El código de integración en Python es el siguiente: 
import requests

url = "https://api.acedata.cloud/face/change-gender"

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

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

response = requests.post(url, json=payload, headers=headers)
print(response.text)

​
Manejo de errores

Al llamar a la API, si se encuentra con un error, la API devolverá el código de error y la información correspondiente. Por ejemplo:
  • 400 token_mismatched: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 400 api_not_implemented: Solicitud incorrecta, posiblemente debido a parámetros faltantes o inválidos.
  • 401 invalid_token: No autorizado, token de autorización inválido o faltante.
  • 429 too_many_requests: Demasiadas solicitudes, ha superado el límite de tasa.
  • 500 api_error: Error interno del servidor, algo salió mal en el servidor.

​
Ejemplo de respuesta de error

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "fetch failed"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

​
Conclusión

A través de este documento, ha aprendido cómo utilizar la API de conversión de género facial para que los usuarios suban una imagen de rostro y, basándose en algoritmos de edición y generación de rostros, produzcan una imagen de conversión de género facial. Esperamos que este documento le ayude a integrar y utilizar mejor esta API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.