Web- / HTML-Integration – ByByBG API-Dokumentation
🌐 Web-Integration

Web- / HTML-API-Integration

Integrieren Sie die KI-gestützte Hintergrundentfernung in Websites und Webanwendungen mit HTML-Formularen, JavaScript und sicheren Backend-APIs.

EINFÜHRUNG

Empfohlener Integrationsablauf

Für maximale Sicherheit sollte Ihr API-Schlüssel niemals direkt im Frontend-JavaScript offengelegt werden.

Empfohlen: Frontend lädt Bild hoch → Backend ruft API auf → Backend liefert das verarbeitete Bild zurück.
📤

Bild hochladen

Benutzer wählen Bilder aus und laden sie über HTML-Uploadformulare oder Drag-and-Drop-Oberflächen hoch.

🔐

Backend-Proxy

Ihr Backend sendet Anfragen sicher mit Ihrem privaten API-Schlüssel an die ByByBG API.

KI-Verarbeitung

Das Bild wird mit fortschrittlichen KI-Modellen zur Hintergrundentfernung verarbeitet.

🖼️

Ergebnis zurückgeben

Ein transparentes PNG-Bild wird sofort an den Browser zurückgegeben.

STEP 1

HTML-Uploadformular

Erstellen Sie eine einfache Upload-Oberfläche, mit der Benutzer Bilder auswählen und hochladen können.

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

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

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

Frontend-JavaScript

Senden Sie hochgeladene Bilder sicher über JavaScript-Fetch-Anfragen an Ihren Backend-Endpunkt.

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

Aufgaben des Backends

  • API-Schlüssel sicher auf dem Server speichern.
  • Hochgeladene Bilddateien ordnungsgemäß validieren.
  • Sichere API-Anfragen an die ByByBG-Server senden.
  • Verarbeitete transparente PNG-Bilder zurückgeben.
  • API-Fehler und ungültige Anfragen korrekt behandeln.
SECURITY

Wichtige Sicherheitsregeln

Veröffentlichen Sie Ihren API-Schlüssel niemals im Frontend-JavaScript oder in öffentlichen Repositories.
  • Verwenden Sie sichere Backend-Proxy-Endpunkte.
  • Speichern Sie API-Schlüssel in Umgebungsvariablen.
  • Validieren Sie Uploads serverseitig.
  • Legen Sie Upload-Größenbeschränkungen für mehr Sicherheit fest.
  • Verhindern Sie Missbrauch durch Rate-Limiting-Systeme.
ERRORS

Häufige API-Fehler

Status
Description
401
Ungültiger oder fehlender API-Schlüssel.
413
Die hochgeladene Bilddatei ist zu groß.
429
Zu viele Anfragen. Das Ratenlimit wurde überschritten.
500
Interner Serverfehler bei der Verarbeitung.

Weiter zur erweiterten JavaScript-Integration

Erfahren Sie, wie Sie fortschrittliche Frontend-Integrationen, Fortschrittsbalken, Vorschauen und Echtzeit-Workflows mit JavaScript erstellen.