تكامل Flutter API – توثيق ByByBG
📱 Flutter SDK

تكامل Flutter

تعرّف على كيفية دمج إزالة الخلفية بالذكاء الاصطناعي داخل تطبيقات Flutter لأندرويد وiOS باستخدام رفع الصور متعدد الأجزاء وطلبات HTTP.

المقدمة

واجهة إزالة الخلفية لـ Flutter

قم بدمج واجهة ByByBG API داخل تطبيقات Flutter باستخدام رفع الصور متعدد الأجزاء وطلبات HTTP وسير عمل إزالة الخلفية بالذكاء الاصطناعي.

موصى به: استخدم خوادم Proxy خلفية آمنة في تطبيقات الإنتاج بدلاً من كشف مفاتيح API مباشرة داخل تطبيقات الهاتف.
STEP 1

تثبيت حزمة HTTP

أضف تبعية HTTP المطلوبة داخل مشروع Flutter قبل تنفيذ طلبات API.

dependencies:
  http: ^1.2.0
STEP 2

استيراد الحزم المطلوبة

قم باستيراد مكتبات Dart IO وHTTP قبل استخدام مثال طلب API.

import 'dart:io';

import 'package:http/http.dart'
as http;
STEP 3

مثال طلب Flutter API

قم برفع الصور واستلام ملفات PNG شفافة باستخدام طلبات HTTP متعددة الأجزاء في Flutter.

Future<void>
removeBackground(File imageFile)
async {

    var request =
    http.MultipartRequest(

        'POST',

        Uri.parse(
        'https://api.bybybg.com/v1/remove-bg'
        )

    );

    request.headers['X-API-Key'] =
    'YOUR_API_KEY';

    request.files.add(

        await http.MultipartFile
        .fromPath(
            'file',
            imageFile.path
        )

    );

    var response =
    await request.send();

    if(response.statusCode == 200){

        print(
        "Background removed"
        );

    }else{

        print(
        "Error: ${response.statusCode}"
        );

    }
}
FEATURES

ميزات Flutter الموصى بها

🖼️

اختيار الصور

السماح للمستخدمين باختيار الصور من معرض الجهاز أو الكاميرا.

مؤشر التحميل

عرض مؤشرات تحميل متحركة أثناء معالجة الصور بالذكاء الاصطناعي.

💾

حفظ PNG

حفظ ملفات PNG الشفافة مباشرة داخل ذاكرة الجهاز.

🔒

خادم خلفي آمن

حماية مفاتيح API الخاصة باستخدام خوادم Proxy خلفية.

BEST PRACTICES

الممارسات الموصى بها

  • قم بضغط الصور الكبيرة قبل رفعها.
  • اعرض مؤشرات تقدم الرفع لتحسين تجربة المستخدم.
  • تعامل مع مهلات الشبكة بشكل صحيح.
  • لا تعرض مفاتيح API الخاصة علنًا أبدًا.
  • قم بتخزين الصور المعالجة محليًا لتحسين الأداء.
ERRORS

أخطاء API الشائعة

Status
Description
401
مفتاح API غير صالح أو مفقود.
413
ملف الصورة المرفوع كبير جدًا.
429
طلبات كثيرة جدًا. تم تجاوز الحد المسموح.
500
خطأ داخلي أثناء المعالجة.

تابع إلى تكامل Kotlin

تعرّف على كيفية دمج واجهة ByByBG API داخل تطبيقات أندرويد الأصلية باستخدام Kotlin.