ailabtools 0.5.4

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: e696c83015dc6e942b081f6544ad6317fc1f4d2d05b829a533a79846298a984b
+  data.tar.gz: f6de741108ab175212bf5f4beeb11deddb3bf760099e7e355b4d14a7ab0d18d8
+SHA512:
+  metadata.gz: 6db742534d0fc3825a29da99a674a1e85b12a8943e94ea063ccba734acfe55983ae6e6ac3a9ed3b36b6ca480afb473ce40e31f5c32e9f94b56ba526543f98c1d
+  data.tar.gz: 3ed4834f782379c2b7eb90c42f90e76ed089c52361ebbac6255b2593a1f1f9120fa18513d3a8be1d58a3828832a157818cdc5bd86fda3fad808b62b2bfebe396

data/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## 0.5.4
+
+- Initial Ruby SDK release.
+- Added all 93 AILabTools SDK endpoints.
+- Added typed parameter and response objects.
+- Added RubyGems packaging metadata.

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AILabTools
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

data/README.md

@@ -0,0 +1,121 @@
+# AILabTools SDK for Ruby
+
+Official Ruby SDK for the [AILabTools AI image APIs](https://www.ailabtools.com/docs). It covers background removal, image upscaling, object removal, portrait retouching, hairstyle changes, virtual try-on, skin analysis, and other AI photo workflows.
+
+## Requirements
+
+- Ruby 2.6 or later
+- RubyGems
+
+The SDK uses Ruby standard-library `net/http` and has no runtime gem dependencies.
+
+## Installation
+
+```bash
+gem install ailabtools
+```
+
+Bundler:
+
+```ruby
+gem "ailabtools", "~> 0.5.4"
+```
+
+## Quick Start
+
+Create an API key in the [AILabTools Developer Console](https://www.ailabtools.com/developer).
+
+```ruby
+require "ailabtools"
+
+client = AILabTools::Client.new(api_key: ENV.fetch("AILAB_API_KEY"))
+
+params = AILabTools::Generated::Params::CutoutUniversalBackgroundRemovalParams.new(
+  image: AILabTools::FileInput.from_path("photo.jpg", content_type: "image/jpeg"),
+  return_form: "whiteBK"
+)
+
+result = client.background.remove(params)
+puts result.data&.image_url
+```
+
+## File Uploads
+
+```ruby
+AILabTools::FileInput.from_path("photo.jpg", content_type: "image/jpeg")
+AILabTools::FileInput.from_bytes(bytes, filename: "photo.jpg", content_type: "image/jpeg")
+AILabTools::FileInput.from_io(io, filename: "photo.jpg", content_type: "image/jpeg")
+```
+
+## Async Tasks
+
+```ruby
+task = client.portrait.change_hairstyle(params)
+task_id = task.task_id || task.data&.task_id
+result = client.wait_for_task(task_id, interval: 5, timeout: 300)
+puts result.data&.task_status
+```
+
+## Error Handling
+
+```ruby
+begin
+  result = client.background.remove(params)
+rescue AILabTools::APIError => error
+  warn error.message
+  warn error.request_id
+  warn error.log_id
+  warn error.error_code
+end
+```
+
+## Client Configuration
+
+```ruby
+client = AILabTools::Client.new(
+  api_key: ENV.fetch("AILAB_API_KEY"),
+  base_url: "https://www.ailabapi.com",
+  timeout: 120
+)
+```
+
+## Popular Aliases
+
+| Use case | Ruby method |
+| --- | --- |
+| Remove image background | `client.background.remove(params)` |
+| Upscale an image | `client.image.upscale(params)` |
+| Remove objects | `client.image.remove_objects(params)` |
+| Change hairstyle | `client.portrait.change_hairstyle(params)` |
+| Retouch portrait | `client.portrait.retouch(params)` |
+
+## Features
+
+- Typed Ruby parameter and response classes for all 93 SDK endpoints
+- Standard-library HTTP transport
+- Path, byte-string, and IO file uploads
+- Automatic snake_case-to-wire-name parameter mapping
+- Structured API exceptions with request and log IDs
+- Async task polling
+- RubyGems-ready gemspec metadata
+
+## RubyGems Publishing
+
+Before publishing:
+
+1. Create a RubyGems account and configure API credentials.
+2. Run `gem build ailabtools.gemspec`.
+3. Run `gem push ailabtools-0.5.4.gem`.
+
+The gem name is `ailabtools` and the require name is `ailabtools`.
+
+## Links
+
+- [Get an AILabTools API key](https://www.ailabtools.com/developer)
+- [AILabTools API documentation](https://www.ailabtools.com/docs)
+- [AILabTools SDK source code](https://github.com/ailabtools/ailabtools-sdk)
+- [Report an SDK issue](https://github.com/ailabtools/ailabtools-sdk/issues)
+
+## License
+
+[MIT](LICENSE)

data/lib/ailabtools/api/background_api.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module AILabTools
+  module API
+    class BackgroundAPI
+      def initialize(cutout)
+        @cutout = cutout
+      end
+
+      def remove(params)
+        @cutout.cutout_universal_background_removal(params)
+      end
+    end
+  end
+end

data/lib/ailabtools/api/common_api.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module AILabTools
+  module API
+    class CommonAPI
+      def initialize(requester)
+        @requester = requester
+      end
+
+      def common_query_async_task_result(params)
+        @requester.request("GET", "/api/common/query-async-task-result", params, AILabTools::Generated::Responses::CommonQueryAsyncTaskResultResponse)
+      end
+
+      def common_query_credits(params)
+        @requester.request("GET", "/api/common/query-credits", params, AILabTools::Generated::Responses::CommonQueryCreditsResponse)
+      end
+
+    end
+  end
+end

data/lib/ailabtools/api/cutout_api.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module AILabTools
+  module API
+    class CutoutAPI
+      def initialize(requester)
+        @requester = requester
+      end
+
+      def cutout_clothing_background_removal(params)
+        @requester.request("POST", "/api/cutout/general/apparel-background-removal", params, AILabTools::Generated::Responses::CutoutClothingBackgroundRemovalResponse)
+      end
+
+      def cutout_product_background_removal(params)
+        @requester.request("POST", "/api/cutout/general/commodity-background-removal", params, AILabTools::Generated::Responses::CutoutProductBackgroundRemovalResponse)
+      end
+
+      def cutout_food_background_removal(params)
+        @requester.request("POST", "/api/cutout/general/food-background-removal", params, AILabTools::Generated::Responses::CutoutFoodBackgroundRemovalResponse)
+      end
+
+      def cutout_universal_background_removal(params)
+        @requester.request("POST", "/api/cutout/general/universal-background-removal", params, AILabTools::Generated::Responses::CutoutUniversalBackgroundRemovalResponse)
+      end
+
+      def cutout_avatar_extraction(params)
+        @requester.request("POST", "/api/cutout/portrait/avatar-extraction", params, AILabTools::Generated::Responses::CutoutAvatarExtractionResponse)
+      end
+
+      def cutout_hair_extraction(params)
+        @requester.request("POST", "/api/cutout/portrait/hairstyle-extraction", params, AILabTools::Generated::Responses::CutoutHairExtractionResponse)
+      end
+
+      def cutout_human_background_removal(params)
+        @requester.request("POST", "/api/cutout/portrait/portrait-background-removal", params, AILabTools::Generated::Responses::CutoutHumanBackgroundRemovalResponse)
+      end
+
+      def cutout_hd_universal_background_removal(params)
+        @requester.request("POST", "/api/cutout/general/hd-universal-background-removal", params, AILabTools::Generated::Responses::CutoutHDUniversalBackgroundRemovalResponse)
+      end
+
+      def cutout_hd_human_body_background_removal(params)
+        @requester.request("POST", "/api/cutout/portrait/hd-portrait-background-removal", params, AILabTools::Generated::Responses::CutoutHdHumanBodyBackgroundRemovalResponse)
+      end
+
+    end
+  end
+end

data/lib/ailabtools/api/image_api.rb

@@ -0,0 +1,140 @@
+# frozen_string_literal: true
+
+module AILabTools
+  module API
+    class ImageAPI
+      def initialize(requester)
+        @requester = requester
+      end
+
+      def image_querying_async_task_results(params)
+        @requester.request("GET", "/api/image/asyn-task-results", params, AILabTools::Generated::Responses::ImageQueryingAsyncTaskResultsResponse)
+      end
+
+      def image_ai_image_extender(params)
+        @requester.request("POST", "/api/image/editing/ai-image-extender", params, AILabTools::Generated::Responses::ImageAiImageExtenderResponse)
+      end
+
+      def image_ai_object_replacer(params)
+        @requester.request("POST", "/api/image/editing/ai-object-replacer", params, AILabTools::Generated::Responses::ImageAiObjectReplacerResponse)
+      end
+
+      def image_ai_image_cropping(params)
+        @requester.request("POST", "/api/image/editing/image-cropping", params, AILabTools::Generated::Responses::ImageAIImageCroppingResponse)
+      end
+
+      def image_erasure(params)
+        @requester.request("POST", "/api/image/editing/image-erase", params, AILabTools::Generated::Responses::ImageErasureResponse)
+      end
+
+      def image_invisible_image_watermark(params)
+        @requester.request("POST", "/api/image/editing/image-invisible-image-watermark", params, AILabTools::Generated::Responses::ImageInvisibleImageWatermarkResponse)
+      end
+
+      def image_invisible_text_watermark(params)
+        @requester.request("POST", "/api/image/editing/image-invisible-text-watermarking", params, AILabTools::Generated::Responses::ImageInvisibleTextWatermarkResponse)
+      end
+
+      def image_intelligent_composition(params)
+        @requester.request("POST", "/api/image/editing/intelligent-composition", params, AILabTools::Generated::Responses::ImageIntelligentCompositionResponse)
+      end
+
+      def image_photo_editing(params)
+        @requester.request("POST", "/api/image/editing/photo-retouching", params, AILabTools::Generated::Responses::ImagePhotoEditingResponse)
+      end
+
+      def image_remove_objects(params)
+        @requester.request("POST", "/api/image/editing/remove-objects", params, AILabTools::Generated::Responses::ImageRemoveObjectsResponse)
+      end
+
+      def remove_objects(params)
+        image_remove_objects(params)
+      end
+
+      def image_remove_objects_advanced(params)
+        @requester.request("POST", "/api/image/editing/remove-objects-advanced", params, AILabTools::Generated::Responses::ImageRemoveObjectsAdvancedResponse)
+      end
+
+      def image_remove_objects_pro(params)
+        @requester.request("POST", "/api/image/editing/remove-objects-pro", params, AILabTools::Generated::Responses::ImageRemoveObjectsProResponse)
+      end
+
+      def image_ai_cartoon_generator(params)
+        @requester.request("POST", "/api/image/effects/ai-anime-generator", params, AILabTools::Generated::Responses::ImageAICartoonGeneratorResponse)
+      end
+
+      def image_coloring(params)
+        @requester.request("POST", "/api/image/effects/image-colorization", params, AILabTools::Generated::Responses::ImageColoringResponse)
+      end
+
+      def image_style_transfer(params)
+        @requester.request("POST", "/api/image/effects/image-style-conversion", params, AILabTools::Generated::Responses::ImageStyleTransferResponse)
+      end
+
+      def image_style_migration(params)
+        @requester.request("POST", "/api/image/effects/image-style-migration", params, AILabTools::Generated::Responses::ImageStyleMigrationResponse)
+      end
+
+      def image_color_enhancement(params)
+        @requester.request("POST", "/api/image/enhance/image-color-enhancement", params, AILabTools::Generated::Responses::ImageColorEnhancementResponse)
+      end
+
+      def image_contrast_enhancement(params)
+        @requester.request("POST", "/api/image/enhance/image-contrast-enhancement", params, AILabTools::Generated::Responses::ImageContrastEnhancementResponse)
+      end
+
+      def image_dehaze(params)
+        @requester.request("POST", "/api/image/enhance/image-defogging", params, AILabTools::Generated::Responses::ImageDehazeResponse)
+      end
+
+      def image_lossless_enlargement(params)
+        @requester.request("POST", "/api/image/enhance/image-lossless-enlargement", params, AILabTools::Generated::Responses::ImageLosslessEnlargementResponse)
+      end
+
+      def upscale(params)
+        image_lossless_enlargement(params)
+      end
+
+      def image_clarity_enhancement(params)
+        @requester.request("POST", "/api/image/enhance/image-sharpness-enhancement", params, AILabTools::Generated::Responses::ImageClarityEnhancementResponse)
+      end
+
+      def image_distortion_correction(params)
+        @requester.request("POST", "/api/image/enhance/stretch-image-recovery", params, AILabTools::Generated::Responses::ImageDistortionCorrectionResponse)
+      end
+
+      def image_composition_aesthetics_score(params)
+        @requester.request("POST", "/api/image/rating/image-composition-aesthetics-scoring", params, AILabTools::Generated::Responses::ImageCompositionAestheticsScoreResponse)
+      end
+
+      def image_exposure_rating(params)
+        @requester.request("POST", "/api/image/rating/image-exposure-score", params, AILabTools::Generated::Responses::ImageExposureRatingResponse)
+      end
+
+      def image_ai_nail_art(params)
+        @requester.request("POST", "/api/image/editing/ai-nail-art", params, AILabTools::Generated::Responses::ImageAINailArtResponse)
+      end
+
+      def image_ai_nail_art_pro(params)
+        @requester.request("POST", "/api/image/editing/ai-nail-art-pro", params, AILabTools::Generated::Responses::ImageAINailArtProResponse)
+      end
+
+      def image_ai_photography(params)
+        @requester.request("POST", "/api/image/effects/ai-photography", params, AILabTools::Generated::Responses::ImageAIPhotographyResponse)
+      end
+
+      def image_ai_emoji_generator(params)
+        @requester.request("POST", "/api/image/effects/photo-to-emoji-grid", params, AILabTools::Generated::Responses::ImageAIEmojiGeneratorResponse)
+      end
+
+      def image_photo_to_coloring_page(params)
+        @requester.request("POST", "/api/image/effects/photo-to-line-art", params, AILabTools::Generated::Responses::ImagePhotoToColoringPageResponse)
+      end
+
+      def image_ai_flower_wallpaper(params)
+        @requester.request("POST", "/api/image/generation/ai-flower-wallpaper", params, AILabTools::Generated::Responses::ImageAIFlowerWallpaperResponse)
+      end
+
+    end
+  end
+end

data/lib/ailabtools/api/portrait_api.rb

@@ -0,0 +1,228 @@
+# frozen_string_literal: true
+
+module AILabTools
+  module API
+    class PortraitAPI
+      def initialize(requester)
+        @requester = requester
+      end
+
+      def portrait_face_analyzer(params)
+        @requester.request("POST", "/api/portrait/analysis/face-analyzer", params, AILabTools::Generated::Responses::PortraitFaceAnalyzerResponse)
+      end
+
+      def portrait_face_analyzer_advanced(params)
+        @requester.request("POST", "/api/portrait/analysis/face-analyzer-advanced", params, AILabTools::Generated::Responses::PortraitFaceAnalyzerAdvancedResponse)
+      end
+
+      def portrait_facial_landmarks(params)
+        @requester.request("POST", "/api/portrait/analysis/face-key-points", params, AILabTools::Generated::Responses::PortraitFacialLandmarksResponse)
+      end
+
+      def portrait_skin_analysis_basic(params)
+        @requester.request("POST", "/api/portrait/analysis/skin-analysis", params, AILabTools::Generated::Responses::PortraitSkinAnalysisBasicResponse)
+      end
+
+      def portrait_skin_analysis_advanced(params)
+        @requester.request("POST", "/api/portrait/analysis/skin-analysis-advanced", params, AILabTools::Generated::Responses::PortraitSkinAnalysisAdvancedResponse)
+      end
+
+      def portrait_skin_analysis_professional(params)
+        @requester.request("POST", "/api/portrait/analysis/skin-analysis-pro", params, AILabTools::Generated::Responses::PortraitSkinAnalysisProfessionalResponse)
+      end
+
+      def portrait_skin_disease_detection(params)
+        @requester.request("POST", "/api/portrait/analysis/skin-disease-detection", params, AILabTools::Generated::Responses::PortraitSkinDiseaseDetectionResponse)
+      end
+
+      def portrait_try_on_clothes(params)
+        @requester.request("POST", "/api/portrait/editing/try-on-clothes", params, AILabTools::Generated::Responses::PortraitTryOnClothesResponse)
+      end
+
+      def portrait_try_on_clothes_pro(params)
+        @requester.request("POST", "/api/portrait/editing/try-on-clothes-pro", params, AILabTools::Generated::Responses::PortraitTryOnClothesProResponse)
+      end
+
+      def portrait_facial_blurring(params)
+        @requester.request("POST", "/api/portrait/effects/blurred-faces", params, AILabTools::Generated::Responses::PortraitFacialBlurringResponse)
+      end
+
+      def portrait_expression_editing(params)
+        @requester.request("POST", "/api/portrait/effects/emotion-editor", params, AILabTools::Generated::Responses::PortraitExpressionEditingResponse)
+      end
+
+      def portrait_face_restoration_enhancement(params)
+        @requester.request("POST", "/api/portrait/effects/enhance-face", params, AILabTools::Generated::Responses::PortraitFaceRestorationEnhancementResponse)
+      end
+
+      def portrait_face_attribute_editing(params)
+        @requester.request("POST", "/api/portrait/effects/face-attribute-editing", params, AILabTools::Generated::Responses::PortraitFaceAttributeEditingResponse)
+      end
+
+      def portrait_facial_beautification(params)
+        @requester.request("POST", "/api/portrait/effects/face-beauty", params, AILabTools::Generated::Responses::PortraitFacialBeautificationResponse)
+      end
+
+      def portrait_facial_beautification_advanced(params)
+        @requester.request("POST", "/api/portrait/effects/face-beauty-advanced", params, AILabTools::Generated::Responses::PortraitFacialBeautificationAdvancedResponse)
+      end
+
+      def portrait_facial_beautification_pro(params)
+        @requester.request("POST", "/api/portrait/effects/face-beauty-pro", params, AILabTools::Generated::Responses::PortraitFacialBeautificationProResponse)
+      end
+
+      def portrait_facial_filters(params)
+        @requester.request("POST", "/api/portrait/effects/face-filter", params, AILabTools::Generated::Responses::PortraitFacialFiltersResponse)
+      end
+
+      def portrait_face_fusion(params)
+        @requester.request("POST", "/api/portrait/effects/face-fusion", params, AILabTools::Generated::Responses::PortraitFaceFusionResponse)
+      end
+
+      def portrait_hairstyle_editing(params)
+        @requester.request("POST", "/api/portrait/effects/hairstyle-editor", params, AILabTools::Generated::Responses::PortraitHairstyleEditingResponse)
+      end
+
+      def portrait_hairstyle_editing_pro(params)
+        @requester.request("POST", "/api/portrait/effects/hairstyle-editor-pro", params, AILabTools::Generated::Responses::PortraitHairstyleEditingProResponse)
+      end
+
+      def change_hairstyle(params)
+        portrait_hairstyle_editing_pro(params)
+      end
+
+      def portrait_lips_color_changer(params)
+        @requester.request("POST", "/api/portrait/effects/lips-color-changer", params, AILabTools::Generated::Responses::PortraitLipsColorChangerResponse)
+      end
+
+      def portrait_live_photos(params)
+        @requester.request("POST", "/api/portrait/effects/live-photo", params, AILabTools::Generated::Responses::PortraitLivePhotosResponse)
+      end
+
+      def portrait_cartoon_yourself(params)
+        @requester.request("POST", "/api/portrait/effects/portrait-animation", params, AILabTools::Generated::Responses::PortraitCartoonYourselfResponse)
+      end
+
+      def portrait_intelligent_beautification(params)
+        @requester.request("POST", "/api/portrait/effects/smart-beauty", params, AILabTools::Generated::Responses::PortraitIntelligentBeautificationResponse)
+      end
+
+      def retouch(params)
+        portrait_intelligent_beautification(params)
+      end
+
+      def portrait_intelligent_face_slimming(params)
+        @requester.request("POST", "/api/portrait/effects/smart-face-slimming", params, AILabTools::Generated::Responses::PortraitIntelligentFaceSlimmingResponse)
+      end
+
+      def portrait_intelligent_skin_retouching(params)
+        @requester.request("POST", "/api/portrait/effects/smart-skin", params, AILabTools::Generated::Responses::PortraitIntelligentSkinRetouchingResponse)
+      end
+
+      def portrait_try_on_clothes_refiner(params)
+        @requester.request("POST", "/api/portrait/enhance/try-on-clothes-refiner", params, AILabTools::Generated::Responses::PortraitTryOnClothesRefinerResponse)
+      end
+
+      def portrait_ai_face_rating(params)
+        @requester.request("POST", "/api/portrait/analysis/ai-face-rating", params, AILabTools::Generated::Responses::PortraitAIFaceRatingResponse)
+      end
+
+      def portrait_ai_bald(params)
+        @requester.request("POST", "/api/portrait/editing/ai-bald", params, AILabTools::Generated::Responses::PortraitAIBaldResponse)
+      end
+
+      def portrait_ai_beard_removal(params)
+        @requester.request("POST", "/api/portrait/editing/ai-beard-removal", params, AILabTools::Generated::Responses::PortraitAIBeardRemovalResponse)
+      end
+
+      def portrait_ai_beard_styling(params)
+        @requester.request("POST", "/api/portrait/editing/ai-beard-styling", params, AILabTools::Generated::Responses::PortraitAIBeardStylingResponse)
+      end
+
+      def portrait_ai_breast_expansion(params)
+        @requester.request("POST", "/api/portrait/editing/ai-big-tits", params, AILabTools::Generated::Responses::PortraitAIBreastExpansionResponse)
+      end
+
+      def portrait_ai_butt_enhancement(params)
+        @requester.request("POST", "/api/portrait/editing/ai-butt-enhancement", params, AILabTools::Generated::Responses::PortraitAIButtEnhancementResponse)
+      end
+
+      def portrait_ai_colored_contacts(params)
+        @requester.request("POST", "/api/portrait/editing/ai-colored-contacts", params, AILabTools::Generated::Responses::PortraitAIColoredContactsResponse)
+      end
+
+      def portrait_ai_eyebrows(params)
+        @requester.request("POST", "/api/portrait/editing/ai-eyebrows", params, AILabTools::Generated::Responses::PortraitAIEyebrowsResponse)
+      end
+
+      def portrait_ai_eyelashes(params)
+        @requester.request("POST", "/api/portrait/editing/ai-eyelashes", params, AILabTools::Generated::Responses::PortraitAIEyelashesResponse)
+      end
+
+      def portrait_ai_eyeshadow_try_on(params)
+        @requester.request("POST", "/api/portrait/editing/ai-eyeshadow", params, AILabTools::Generated::Responses::PortraitAIEyeshadowTryOnResponse)
+      end
+
+      def portrait_ai_face_swap(params)
+        @requester.request("POST", "/api/portrait/editing/ai-face-swap", params, AILabTools::Generated::Responses::PortraitAIFaceSwapResponse)
+      end
+
+      def portrait_ai_fat_filter(params)
+        @requester.request("POST", "/api/portrait/editing/ai-fat-filter", params, AILabTools::Generated::Responses::PortraitAIFatFilterResponse)
+      end
+
+      def portrait_ai_hair_color(params)
+        @requester.request("POST", "/api/portrait/editing/ai-hair-color", params, AILabTools::Generated::Responses::PortraitAIHairColorResponse)
+      end
+
+      def portrait_ai_hair_loss_simulation(params)
+        @requester.request("POST", "/api/portrait/editing/ai-hair-loss-simulation", params, AILabTools::Generated::Responses::PortraitAIHairLossSimulationResponse)
+      end
+
+      def portrait_ai_lip_enhancement(params)
+        @requester.request("POST", "/api/portrait/editing/ai-lip-enhancement", params, AILabTools::Generated::Responses::PortraitAILipEnhancementResponse)
+      end
+
+      def portrait_ai_waist_slimming(params)
+        @requester.request("POST", "/api/portrait/editing/ai-waist-slimming", params, AILabTools::Generated::Responses::PortraitAIWaistSlimmingResponse)
+      end
+
+      def portrait_try_on_clothes_premium(params)
+        @requester.request("POST", "/api/portrait/editing/try-on-clothes-premium", params, AILabTools::Generated::Responses::PortraitTryOnClothesPremiumResponse)
+      end
+
+      def portrait_ai_big_head_effect(params)
+        @requester.request("POST", "/api/portrait/effects/ai-big-head-effect", params, AILabTools::Generated::Responses::PortraitAIBigHeadEffectResponse)
+      end
+
+      def portrait_ai_halloween_mask(params)
+        @requester.request("POST", "/api/portrait/effects/ai-halloween-mask", params, AILabTools::Generated::Responses::PortraitAIHalloweenMaskResponse)
+      end
+
+      def portrait_ai_lip_bite_expressions(params)
+        @requester.request("POST", "/api/portrait/effects/ai-lip-bite-expressions", params, AILabTools::Generated::Responses::PortraitAILipBiteExpressionsResponse)
+      end
+
+      def portrait_ai_red_lip_gloss(params)
+        @requester.request("POST", "/api/portrait/effects/ai-red-lip-gloss", params, AILabTools::Generated::Responses::PortraitAIRedLipGlossResponse)
+      end
+
+      def portrait_ai_square_face_filter(params)
+        @requester.request("POST", "/api/portrait/effects/ai-square-face-filter", params, AILabTools::Generated::Responses::PortraitAISquareFaceFilterResponse)
+      end
+
+      def portrait_expression_editing_advanced(params)
+        @requester.request("POST", "/api/portrait/effects/emotion-editor-advanced", params, AILabTools::Generated::Responses::PortraitExpressionEditingAdvancedResponse)
+      end
+
+      def portrait_hairstyle_editing_premium(params)
+        @requester.request("POST", "/api/portrait/effects/hairstyle-editor-premium", params, AILabTools::Generated::Responses::PortraitHairstyleEditingPremiumResponse)
+      end
+
+      def portrait_ai_skin_enhancement_advanced(params)
+        @requester.request("POST", "/api/portrait/effects/smart-skin-advanced", params, AILabTools::Generated::Responses::PortraitAISkinEnhancementAdvancedResponse)
+      end
+
+    end
+  end
+end

data/lib/ailabtools/client.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module AILabTools
+  class Client
+    attr_reader :common, :cutout, :image, :portrait, :background
+
+    def initialize(api_key:, base_url: "https://www.ailabapi.com", timeout: 120)
+      requester = Requester.new(api_key: api_key, base_url: base_url, timeout: timeout)
+      @common = API::CommonAPI.new(requester)
+      @cutout = API::CutoutAPI.new(requester)
+      @image = API::ImageAPI.new(requester)
+      @portrait = API::PortraitAPI.new(requester)
+      @background = API::BackgroundAPI.new(@cutout)
+    end
+
+    def wait_for_task(task_id, interval: 5, timeout: 300, raise_on_failed: true)
+      deadline = Time.now + timeout
+      loop do
+        result = @common.common_query_async_task_result(
+          Generated::Params::CommonQueryAsyncTaskResultParams.new(task_id: task_id)
+        )
+        status = result.data && result.data.task_status || result.task_status
+        return result if status == 2
+        if status == 3
+          raise SDKError, "AILabTools task failed: #{task_id}" if raise_on_failed
+          return result
+        end
+        raise SDKError, "AILabTools task timed out: #{task_id}" if Time.now >= deadline
+        sleep interval if interval.positive?
+      end
+    end
+
+    def close
+      nil
+    end
+  end
+end

data/lib/ailabtools/errors.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module AILabTools
+  class Error < StandardError; end
+
+  class SDKError < Error; end
+
+  class APIError < Error
+    attr_reader :status_code, :request_id, :log_id, :error_code, :error_detail, :raw
+
+    def initialize(message, status_code:, request_id: nil, log_id: nil, error_code: nil, error_detail: nil, raw: nil)
+      super(message)
+      @status_code = status_code
+      @request_id = request_id
+      @log_id = log_id
+      @error_code = error_code
+      @error_detail = error_detail
+      @raw = raw
+    end
+  end
+end