Integración Web / HTML – Documentación API ByByBG
🌐 Integración Web

Integración API Web / HTML

Integra la eliminación de fondos impulsada por IA en sitios web y aplicaciones web utilizando formularios HTML, JavaScript y APIs backend seguras.

INTRODUCCIÓN

Flujo de Integración Recomendado

Para una máxima seguridad, tu clave API nunca debe exponerse directamente dentro del código JavaScript del frontend.

Recomendado: Frontend sube la imagen → Backend llama a la API → Backend devuelve la imagen procesada.
📤

Subir Imagen

Los usuarios seleccionan y suben imágenes utilizando formularios HTML o interfaces de arrastrar y soltar.

🔐

Proxy Backend

Tu backend envía solicitudes de forma segura a la API ByByBG utilizando tu clave API privada.

Procesamiento con IA

La imagen se procesa utilizando modelos avanzados de eliminación de fondos con IA.

🖼️

Devolver Resultado

Una imagen PNG transparente se devuelve instantáneamente al navegador.

STEP 1

Formulario de Carga HTML

Crea una interfaz simple de carga que permita a los usuarios seleccionar y subir imágenes.

<input type="file" id="imageInput">

<button onclick="removeBg()">
    Remove Background
</button>

<div id="result"></div>
STEP 2

JavaScript Frontend

Envía de forma segura las imágenes cargadas a tu endpoint backend utilizando solicitudes Fetch de JavaScript.

async function removeBg(){

    const fileInput =
    document.getElementById("imageInput");

    const result =
    document.getElementById("result");

    if(!fileInput.files.length){
        alert("Select image");
        return;
    }

    const formData = new FormData();

    formData.append(
        "file",
        fileInput.files[0]
    );

    result.innerHTML = "Processing...";

    const response = await fetch(
        "/web/remove-bg",
        {
            method:"POST",
            body:formData
        }
    );

    if(!response.ok){

        result.innerHTML =
        "Something went wrong";

        return;
    }

    const blob =
    await response.blob();

    const url =
    URL.createObjectURL(blob);

    result.innerHTML = `
        <img src="${url}">
    `;
}
STEP 3

Responsabilidades del Backend

  • Almacenar las claves API de forma segura en el servidor.
  • Validar correctamente los archivos de imagen cargados.
  • Enviar solicitudes API seguras a los servidores de ByByBG.
  • Devolver imágenes PNG transparentes procesadas.
  • Gestionar correctamente errores API y solicitudes inválidas.
SECURITY

Reglas Importantes de Seguridad

Nunca expongas tu clave API en JavaScript frontend ni en repositorios públicos.
  • Utiliza endpoints proxy backend seguros.
  • Almacena las claves API en variables de entorno.
  • Valida las cargas en el lado del servidor.
  • Aplica límites de tamaño de carga por seguridad.
  • Evita abusos mediante sistemas de limitación de solicitudes.
ERRORS

Errores Comunes de la API

Status
Description
401
Clave API inválida o faltante.
413
El archivo de imagen cargado es demasiado grande.
429
Demasiadas solicitudes. Se ha excedido el límite permitido.
500
Error interno de procesamiento del servidor.

Continúa con la Integración Avanzada en JavaScript

Aprende a crear integraciones frontend avanzadas, barras de progreso, vistas previas y flujos de trabajo en tiempo real utilizando JavaScript.