Integrasi Web / HTML – Dokumentasi API ByByBG
🌐 Integrasi Web

Integrasi API Web / HTML

Integrasikan penghapusan latar belakang berbasis AI ke dalam situs web dan aplikasi web menggunakan formulir HTML, JavaScript, dan API backend yang aman.

PENDAHULUAN

Alur Integrasi yang Direkomendasikan

Untuk keamanan maksimal, API Key Anda tidak boleh pernah ditampilkan langsung di dalam kode JavaScript frontend.

Direkomendasikan: Frontend mengunggah gambar → Backend memanggil API → Backend mengembalikan gambar yang telah diproses.
📤

Unggah Gambar

Pengguna memilih dan mengunggah gambar menggunakan formulir unggah HTML atau antarmuka drag-and-drop.

🔐

Proxy Backend

Backend Anda mengirim permintaan dengan aman ke API ByByBG menggunakan API Key pribadi Anda.

Pemrosesan AI

Gambar diproses menggunakan model AI penghapusan latar belakang yang canggih.

🖼️

Kembalikan Hasil

Gambar PNG transparan dikembalikan ke browser secara instan.

STEP 1

Formulir Unggah HTML

Buat antarmuka unggah sederhana yang memungkinkan pengguna memilih dan mengunggah gambar.

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

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

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

JavaScript Frontend

Kirim gambar yang diunggah dengan aman ke endpoint backend Anda menggunakan permintaan JavaScript Fetch.

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

Tanggung Jawab Backend

  • Simpan API Key dengan aman di server.
  • Validasi file gambar yang diunggah dengan benar.
  • Kirim permintaan API yang aman ke server ByByBG.
  • Kembalikan gambar PNG transparan yang telah diproses.
  • Tangani kesalahan API dan permintaan yang tidak valid dengan benar.
SECURITY

Aturan Keamanan Penting

Jangan pernah menampilkan API Key Anda di dalam JavaScript frontend atau repositori publik.
  • Gunakan endpoint proxy backend yang aman.
  • Simpan API Key dalam environment variables.
  • Validasi unggahan di sisi server.
  • Terapkan batas ukuran unggahan untuk keamanan.
  • Cegah penyalahgunaan menggunakan sistem rate limiting.
ERRORS

Kesalahan API Umum

Status
Description
401
API Key tidak valid atau tidak ada.
413
File gambar yang diunggah terlalu besar.
429
Terlalu banyak permintaan. Batas permintaan telah terlampaui.
500
Kesalahan pemrosesan server internal.

Lanjutkan ke Integrasi JavaScript Tingkat Lanjut

Pelajari cara membangun integrasi frontend tingkat lanjut, progress bar, pratinjau, dan alur kerja real-time menggunakan JavaScript.