Kotlin API 集成 – ByByBG 文档
🤖 Kotlin SDK

Kotlin 集成

使用 Kotlin 和 Multipart HTTP 请求,将 AI 背景移除功能集成到原生 Android 应用中。

概览

适用于 Android 的 Kotlin API

Kotlin 使您能够轻松为 Android 应用添加自动背景移除功能。

推荐: 在生产环境中,请使用安全的后端来保护 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 上传示例

使用 Kotlin 和 OkHttp 发送图片并获取透明 PNG 结果。

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

最佳实践

  • 上传前压缩图片。
  • 验证支持的图片格式。
  • 正确处理网络错误和超时。
  • 不要在应用中存储密钥。
  • 在生产环境中使用安全后端。
ERRORS

常见 API 错误

Status
Description
401
缺少 API 密钥或 API 密钥无效。
413
上传的图片文件过大。
429
请求过于频繁,已超出速率限制。
500
服务器内部处理错误。

继续学习错误处理

了解 API 限制、状态码、故障排查方法以及错误处理最佳实践。