Integrazione API Kotlin – Documentazione ByByBG
🤖 Kotlin SDK

Integrazione Kotlin

Integra la rimozione dello sfondo basata su AI nelle applicazioni Android native utilizzando Kotlin e richieste HTTP multipart.

INTRODUZIONE

API Kotlin per Android

Kotlin consente agli sviluppatori Android di integrare facilmente la rimozione automatica dello sfondo tramite l'API ByByBG.

Consigliato: Utilizza un backend sicuro per proteggere le API Key nelle applicazioni di produzione.
STEP 1

Aggiungi la Dipendenza OkHttp

Aggiungi la libreria OkHttp al tuo progetto Android per effettuare richieste API.

implementation(
"com.squareup.okhttp3:okhttp:4.12.0"
)
STEP 2

Importa le Classi Necessarie

Importa le librerie richieste prima di creare richieste multipart.

import okhttp3.*
import java.io.File
STEP 3

Esempio di Upload Kotlin

Carica immagini e ricevi PNG trasparenti utilizzando Kotlin e OkHttp.

val client = OkHttpClient()

val file =
File("/storage/image.jpg")

val requestBody =
MultipartBody.Builder()
.setType(MultipartBody.FORM)

.addFormDataPart(

    "file",

    file.name,

    file.asRequestBody(
        "image/jpeg"
        .toMediaType()
    )

)

.build()

val request = Request.Builder()

.url(
"https://api.bybybg.com/v1/remove-bg"
)

.addHeader(
"X-API-Key",
"YOUR_API_KEY"
)

.post(requestBody)

.build()

client.newCall(request)
.enqueue(object : Callback {

    override fun onFailure(
        call: Call,
        e: IOException
    ) {

        println("Failed")

    }

    override fun onResponse(
        call: Call,
        response: Response
    ) {

        if(response.isSuccessful){

            println(
            "Background removed"
            )

        }else{

            println(
            "Error: ${response.code}"
            )

        }
    }
})
FEATURES

Funzionalità Consigliate

📷

Supporto Fotocamera

Acquisisci immagini direttamente dalla fotocamera del dispositivo.

🖼️

Selezione dalla Galleria

Consenti agli utenti di scegliere immagini dalla galleria.

Indicatore di Caricamento

Mostra il progresso durante il caricamento e l'elaborazione.

💾

Salvataggio PNG

Salva facilmente immagini trasparenti sul dispositivo Android.

BEST PRACTICES

Best Practice

  • Comprimi le immagini prima del caricamento.
  • Convalida i formati immagine supportati.
  • Gestisci correttamente errori di rete e timeout.
  • Non memorizzare API Key private nell'app.
  • Utilizza servizi backend sicuri in produzione.
ERRORS

Errori API Comuni

Status
Description
401
API Key mancante o non valida.
413
Il file immagine caricato è troppo grande.
429
Troppe richieste. Limite di richieste superato.
500
Errore interno di elaborazione del server.

Continua con la Gestione degli Errori

Scopri limiti API, codici di stato, risoluzione dei problemi e best practice per la gestione degli errori.