Интеграция Kotlin API – Документация ByByBG
🤖 Kotlin SDK

Интеграция Kotlin

Интегрируйте удаление фона с помощью ИИ в нативные Android-приложения с использованием Kotlin и multipart HTTP-запросов.

Обзор

Kotlin API для Android

Kotlin позволяет легко добавлять автоматическое удаление фона в Android-приложения.

Рекомендуется: Используйте безопасный backend для защиты API-ключей в продакшен-среде.
STEP 1

Добавление зависимости OkHttp

Добавьте библиотеку OkHttp в Android-проект для выполнения API-запросов.

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

Импорт необходимых классов

Импортируйте необходимые библиотеки перед созданием multipart-запросов.

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

Пример загрузки на Kotlin

Отправьте изображение и получите прозрачный PNG с помощью Kotlin и 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

Рекомендуемые функции

📷

Интеграция камеры

Захватывайте изображения напрямую с камеры устройства.

🖼️

Выбор из галереи

Позвольте пользователям выбирать изображения из галереи.

Индикаторы загрузки

Показывайте прогресс загрузки и обработки.

💾

Сохранение PNG

Легко сохраняйте прозрачные изображения на Android-устройстве.

BEST PRACTICES

Лучшие практики

  • Сжимайте изображения перед загрузкой.
  • Проверяйте поддерживаемые форматы изображений.
  • Корректно обрабатывайте сетевые ошибки и тайм-ауты.
  • Никогда не храните секретные ключи внутри приложения.
  • Используйте безопасный backend в продакшен-среде.
ERRORS

Распространённые ошибки API

Status
Description
401
API-ключ отсутствует или недействителен.
413
Загруженный файл изображения слишком большой.
429
Слишком много запросов. Превышен лимит запросов.
500
Внутренняя ошибка обработки на сервере.

Перейти к обработке ошибок

Узнайте о лимитах API, кодах статуса, устранении неполадок и лучших практиках обработки ошибок.