AILabTools SDK for Dart and Flutter

Official Dart and Flutter SDK for the AILabTools AI image APIs. Add background removal, image upscaling, object removal, portrait retouching, hairstyle changes, virtual try-on, and other AI photo features to Flutter and Dart applications.

Install the AILabTools Dart and Flutter SDK from pub.dev.

Requirements

Dart 3.0 or later
A Flutter version that includes Dart 3.0 or later

Features

Strongly typed parameters and responses for 87 current APIs plus 6 legacy-compatible endpoints
Flutter Android, iOS, web, macOS, Windows, and Linux support
Dart server and command-line application support
Multipart image uploads using platform-independent byte data
Async task polling and structured API errors
Injectable HTTP client for tests and advanced networking

Installation

dart pub add ailabtools

For a Flutter project:

flutter pub add ailabtools

Quick Start

Create or copy an API key from the AILabTools Developer Console.

import 'dart:io';

import 'package:ailabtools/ailabtools.dart';

Future<void> main() async {
  final client = AILabClient(
    apiKey: Platform.environment['AILAB_API_KEY']!,
  );

  try {
    final bytes = await File('photo.jpg').readAsBytes();
    final result = await client.background.remove(
      CutoutUniversalBackgroundRemovalParams(
        image: AILabFile.fromBytes(
          bytes,
          filename: 'photo.jpg',
          contentType: 'image/jpeg',
        ),
        returnForm: 'whiteBK',
      ),
    );

    print(result.data?.imageUrl);
  } finally {
    client.close();
  }
}

Flutter File Upload

AILabFile.fromBytes works across every Flutter platform, including web. For example, with an XFile selected by image_picker:

final bytes = await pickedFile.readAsBytes();
final result = await client.image.upscale(
  ImageLosslessEnlargementParams(
    image: AILabFile.fromBytes(
      bytes,
      filename: pickedFile.name,
      contentType: pickedFile.mimeType,
    ),
    upscaleFactor: 4,
  ),
);

print(result.data?.url);

The SDK exposes camelCase Dart fields and maps them to API request names. For example, upscaleFactor maps to upscale_factor, while returnForm maps to return_form.

Popular Use Cases

Popular API	Typical use case	SDK method	Try online
Cartoon Yourself API	Create cartoon portraits and avatars from photos.	`client.portrait.portraitCartoonYourself()`	Try Cartoon Yourself online
Change Facial Expressions API	Edit smiles, grins, sadness, and other facial expressions.	`client.portrait.portraitExpressionEditing()`	Try Change Facial Expressions online
Hairstyle Changer Premium API	Preview preset hairstyles or transfer a hairstyle from a reference image.	`client.portrait.portraitHairstyleEditingPremium()`	Try Hairstyle Changer online
Try on Clothes Premium API	Generate high-quality virtual clothing try-on results.	`client.portrait.portraitTryOnClothesPremium()`	Try Virtual Clothes Try-On online
Skin Analyze Pro API	Analyze skin condition, texture, tone, acne, pores, and wrinkles.	`client.portrait.portraitSkinAnalysisProfessional()`	Try AI Skin Analyzer online
Face Beauty Pro API	Apply advanced portrait beautification and face shaping.	`client.portrait.portraitFacialBeautificationPro()`	Try Retouch Portraits online
AI Face Swap API	Swap a face into a target portrait while preserving the scene.	`client.portrait.portraitAIFaceSwap()`	Try AI Face Swap online
AI Breast Expansion API	Apply a controlled bust-area adjustment to a portrait.	`client.portrait.portraitAIBreastExpansion()`	Try AI Breast Expansion online

Browse more demos in AILabTools AI Portrait Tools and AILabTools AI Image Tools.

View the complete AILabTools SDK API index.

Common Developer-Friendly Aliases

Use case	Dart alias
Remove image background	`client.background.remove()`
Upscale an image	`client.image.upscale()`
Remove objects	`client.image.removeObjects()`
Change a hairstyle	`client.portrait.changeHairstyle()`
Retouch a portrait	`client.portrait.retouch()`

Every API also has a full method name matching the AILabTools API documentation.

View the complete method and alias reference.

Async Tasks

Some APIs return a task_id. Poll the task until it succeeds, fails, or times out:

final task = await client.portrait.changeHairstyle(params);
final taskId = task.taskId ?? task.data?.taskId;

final result = await client.waitForTask(
  taskId!,
  interval: const Duration(seconds: 5),
  timeout: const Duration(minutes: 5),
);

Error Handling

try {
  final result = await client.background.remove(params);
  print(result.data?.imageUrl);
} on AILabApiException catch (error) {
  print(error.message);
  print(error.requestId);
  print(error.logId);
}

Client Lifecycle

Call client.close() when the SDK creates its own HTTP client. An http.Client supplied through httpClient remains caller-owned and is not closed by the SDK.

License

MIT