Saltar al contenido principal
Este documento presentará una forma de integración de la API de embellecimiento facial, que puede localizar con precisión los rasgos faciales a través de la carga de una imagen de rostro por parte del usuario (puede procesar hasta cinco rostros en una sola imagen), logrando funciones de embellecimiento como suavizado de piel, aclarado de piel, eliminación de acné, entre otros.

​
Proceso de solicitud

Para utilizar la API, primero debe ir a la página correspondiente de la API de embellecimiento 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, volverá automáticamente a la página actual. En la primera solicitud, se le otorgará un límite 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 embellecimiento para obtener la imagen procesada. Primero, necesita transmitir un campo image_url, la imagen del rostro se muestra a continuación:

Luego, también necesitamos cargar los parámetros de información de embellecimiento facial, que se detallan a continuación en la información del cuerpo de la solicitud. 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 seleccionar directamente después de solicitar.
Además, se configuró el cuerpo de la solicitud, que incluye:
  • image_url: el enlace de la imagen del rostro que necesita ser procesada.
  • smoothing: grado de suavizado, rango de valores [0,100]. 0 significa sin suavizado, 100 representa el grado máximo. Valor predeterminado 10.
  • whitening: grado de aclarado, rango de valores [0,100]. 0 significa sin aclarado, 100 representa el grado máximo. Valor predeterminado 30.
  • face_lifting: grado de adelgazamiento facial, rango de valores [0,100]. 0 significa sin adelgazamiento, 100 representa el grado máximo. Valor predeterminado 70.
  • eye_enlarging: grado de agrandamiento de ojos, rango de valores [0,100]. 0 significa sin agrandamiento, 100 representa el grado máximo. Valor predeterminado 70.
Después de seleccionar, puede notar 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/fmu/BeautifyPic/1256437459/1a68c13b-b03c-4c7b-92a1-e4a9b5f1d7ec"
}
Como se puede ver, en el resultado devuelto hay un campo image_url, que es la imagen del rostro después de los cambios de embellecimiento según la entrada. La información del rostro después de los cambios se muestra a continuación:

Se puede observar que la imagen del rostro ha cambiado según la información de embellecimiento ingresada. 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/beautify' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
  "smoothing": 50,
  "whitening": 50,
  "face_lifting": 50,
  "eye_enlarging": 50
}'
El código de integración en Python es el siguiente: 
import requests

url = "https://api.acedata.cloud/face/beautify"

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

payload = {
    "image_url": "https://cdn.acedata.cloud/lrbtcn.jpg",
    "smoothing": 50,
    "whitening": 50,
    "face_lifting": 50,
    "eye_enlarging": 50
}

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 embellecimiento facial para procesar una imagen de rostro cargada por el usuario (puede procesar hasta cinco rostros en una sola imagen), localizando con precisión los rasgos faciales y logrando funciones de embellecimiento como suavizado de piel, aclarado de piel, eliminación de acné, entre otros. Esperamos que este documento le ayude a integrar y utilizar mejor la API. Si tiene alguna pregunta, no dude en ponerse en contacto con nuestro equipo de soporte técnico.