概要
Android向けKotlin API
Kotlinを使用すると、Androidアプリへ自動背景削除機能を簡単に統合できます。
推奨:
本番環境では、APIキーを保護するため安全なバックエンドを使用してください。
STEP 1
OkHttp依存関係を追加
APIリクエストを実行するため、AndroidプロジェクトへOkHttpライブラリを追加してください。
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
ベストプラクティス
- アップロード前に画像を圧縮してください。
- 対応画像形式を検証してください。
- ネットワークエラーやタイムアウトを適切に処理してください。
- 秘密APIキーをアプリ内へ保存しないでください。
- 本番環境では安全なバックエンドサービスを利用してください。
ERRORS
一般的なAPIエラー
Status
Description
401
APIキーが存在しないか無効です。
413
アップロードされた画像ファイルが大きすぎます。
429
リクエストが多すぎます。レート制限を超えました。
500
内部サーバー処理エラー。
エラー処理へ進む
API制限、ステータスコード、トラブルシューティング、およびエラー処理のベストプラクティスを学びましょう。