Integração Kotlin API – Documentação ByByBG
🤖 SDK Kotlin

Integração Kotlin

Integre a remoção de fundo com IA em aplicativos Android nativos usando Kotlin e requisições HTTP multipart.

Visão Geral

API Kotlin para Android

O Kotlin facilita a adição de recursos automáticos de remoção de fundo em aplicativos Android.

Recomendado: Utilize um backend seguro para proteger suas chaves de API em produção.
STEP 1

Adicionar Dependência OkHttp

Adicione a biblioteca OkHttp ao seu projeto Android para realizar requisições da API.

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

Importar Classes Necessárias

Importe as bibliotecas necessárias antes de criar requisições multipart.

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

Exemplo de Upload em Kotlin

Envie uma imagem e receba um PNG transparente usando 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

Recursos Recomendados

📷

Integração com Câmera

Capture imagens diretamente da câmera do dispositivo.

🖼️

Seleção da Galeria

Permita que os usuários escolham imagens da galeria.

Indicadores de Carregamento

Exiba o progresso do upload e do processamento.

💾

Salvar PNG

Salve facilmente imagens transparentes no dispositivo Android.

BEST PRACTICES

Melhores Práticas

  • Comprima imagens antes do upload.
  • Valide formatos de imagem compatíveis.
  • Trate erros de rede e timeouts corretamente.
  • Nunca armazene chaves secretas diretamente no aplicativo.
  • Utilize um backend seguro em ambientes de produção.
ERRORS

Erros Comuns da API

Status
Description
401
Chave de API ausente ou inválida.
413
O arquivo de imagem enviado é muito grande.
429
Muitas requisições. Limite de taxa excedido.
500
Erro interno de processamento do servidor.

Continuar para Tratamento de Erros

Aprenda sobre limites da API, códigos de status, solução de problemas e melhores práticas para tratamento de erros.