Saltar al contenido principal

​
Introducción

Face Change es un servicio de imágenes AI proporcionado por Ace Data Cloud, especializado en procesamiento facial AI. A través de la API unificada de Ace Data Cloud, puedes integrar rápidamente Face Change con JavaScript para realizar funciones como intercambio de rostros, embellecimiento facial, cambio de edad, cambio de género, animación y análisis facial.

​
Requisitos Previos

  • Tener una cuenta en Ace Data Cloud y obtener un API Token
  • Node.js 18+ o un entorno de navegador moderno

​
Uso Básico

El endpoint principal para llamar a la API Face Change es: 
POST https://api.acedata.cloud/face/swap
Ejemplo completo de código JavaScript: 
const response = await fetch("https://api.acedata.cloud/face/swap", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "source_image_url": "https://example.com/source-face.jpg",
  "target_image_url": "https://example.com/target-face.jpg"
}),
});

const result = await response.json();
console.log(result);
Por favor reemplaza YOUR_API_TOKEN con el Token real que obtuviste en la plataforma Ace Data Cloud.

​
Manejo de Respuestas

Se recomienda verificar el código de estado de la respuesta y manejar errores: 
if (response.ok) {
  const result = await response.json();
  console.log("Llamada exitosa:", result);
} else {
  console.error(`Llamada fallida, código de estado: ${response.status}`);
  const error = await response.text();
  console.error(error);
}

​
Encapsulación en Node.js

Se recomienda encapsular en una función reutilizable: 
async function callFaceChange(data) {
  const response = await fetch("https://api.acedata.cloud/face/swap", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.ACE_API_TOKEN}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify(data),
  });
  if (!response.ok) throw new Error(`API error: ${response.status}`);
  return response.json();
}

​
Manejo de Errores

Códigos de error comunes:
Código de EstadoDescripción
401Autenticación fallida, por favor verifica el API Token
403Saldo insuficiente o acceso no autorizado
429Límite de frecuencia de solicitudes excedido
500Error interno del servidor

​
Próximos Pasos