> ## Documentation Index
> Fetch the complete documentation index at: https://ailabtools.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Querying Credits

> Query API credit balances, purchased credits, warning thresholds, and update times for each API identifier.

export const QueryingCreditsTableRow = ({rowSpan = 0, category = "", href = "", apiName = "", sign = ""}) => {
  const normalizedRowSpan = Number(rowSpan) || 0;
  return <tr>
      {normalizedRowSpan > 0 && <td rowSpan={normalizedRowSpan} className="border border-gray-300 p-2 align-middle">
          {category}
        </td>}
      <td className="border border-gray-300 p-2 align-middle">
        {href ? <a href={href}>{apiName}</a> : apiName}
      </td>
      <td className="border border-gray-300 p-2 align-middle">{sign}</td>
    </tr>;
};

## Unique Identification

<Tabs>
  <Tab title="COMMON">
    <table>
      <thead className="border p-2">
        <tr>
          <th className="border p-2">Name</th>
          <th className="border p-2">Unique Identification</th>
        </tr>
      </thead>

      <tbody>
        <QueryingCreditsTableRow apiName="Universal credits (all APIs supported)" sign="common" />
      </tbody>
    </table>
  </Tab>

  <Tab title="AI PORTRAIT">
    <table>
      <thead className="border p-2">
        <tr>
          <th className="border p-2">Category</th>
          <th className="border p-2">Name</th>
          <th className="border p-2">Unique Identification</th>
        </tr>
      </thead>

      <tbody>
        <QueryingCreditsTableRow rowSpan={23} category="Portrait Effects" href="/docs/ai-portrait/effects/portrait-animation" apiName="Cartoon Yourself" sign="portrait_cartoonization" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-fusion" apiName="Merge Portraits" sign="portrait_face_fusion" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/smart-beauty" apiName="Smart Beauty" sign="portrait_intelligent_beautification" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/smart-skin" apiName="AI Skin Enhancement" sign="portrait_intelligent_skin_retouching" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/smart-skin-advanced" apiName="AI Skin Enhancement Advanced" sign="portrait_intelligent_skin_retouching_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/smart-face-slimming" apiName="AI Face Slimming" sign="portrait_intelligent_face_slimming" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-beauty" apiName="Face Beauty" sign="portrait_facial_beautification" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-beauty-advanced" apiName="Face Beauty Advanced" sign="portrait_facial_beautification_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-beauty-pro" apiName="Face Beauty Pro" sign="portrait_facial_beautification_pro" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-filter" apiName="Face Filters" sign="portrait_facial_filters" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/emotion-editor" apiName="Change Facial Expressions" sign="portrait_expression_editing" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/emotion-editor-advanced" apiName="Change Facial Expressions Advanced" sign="portrait_expression_editing_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/hairstyle-editor-pro" apiName="Hairstyle Changer Pro" sign="portrait_hairstyle_editing_pro" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/hairstyle-editor-premium" apiName="Hairstyle Changer Premium" sign="portrait_hairstyle_editing_premium" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/blurred-faces" apiName="Face Blur" sign="portrait_facial_blurring" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/face-attribute-editing" apiName="Age & Gender swap" sign="portrait_face_attribute_editing" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-face-enhancer" apiName="AI Face Enhancer" sign="portrait_face_restoration_enhancement" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/lips-color-changer" apiName="Lips Color Changer" sign="portrait_lips_color_changer" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-square-face-filter" apiName="AI Square Face Filter" sign="portrait_ai_square_face_maker" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-big-head-effect" apiName="AI Big Head Effect" sign="portrait_ai_big_head_characters" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-red-lip-gloss" apiName="AI Red Lip Gloss" sign="portrait_ai_sexy_red_lip_gloss" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-lip-bite-expressions" apiName="AI Lip Bite Expressions" sign="portrait_ai_lip_bite_emoji" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/effects/ai-halloween-mask" apiName="AI Halloween Mask" sign="portrait_ai_halloween_masks" />

        <QueryingCreditsTableRow rowSpan={18} category="Portrait Editing" href="/docs/ai-portrait/editing/ai-breast-expansion" apiName="AI Breast Expansion" sign="portrait_ai_big_tits" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-face-swap" apiName="AI Face Swap" sign="portrait_ai_face_swap" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/try-on-clothes" apiName="Try on Clothes" sign="portrait_try_on_clothes" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/try-on-clothes-pro" apiName="Try on Clothes Pro" sign="portrait_try_on_clothes_pro" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/try-on-clothes-premium" apiName="Try on Clothes Premium" sign="portrait_try_on_clothes_premium" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-colored-contacts" apiName="AI Colored Contacts" sign="portrait_ai_colored_contacts" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-eyelashes" apiName="AI Eyelashes" sign="portrait_ai_eyelashes" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-eyebrows" apiName="AI Eyebrows" sign="portrait_ai_eyebrows" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-hair-color" apiName="AI Hair Color" sign="portrait_ai_hair_color" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-beard-removal" apiName="AI Beard Removal" sign="portrait_ai_beard_removal" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-hair-loss-simulation" apiName="AI Hair Loss Simulation" sign="portrait_ai_hair_loss_simulation" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-beard-styling" apiName="AI Beard Styling" sign="portrait_ai_beard_styling" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-bald" apiName="AI Bald" sign="portrait_ai_bald" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-butt-enhancement" apiName="AI Butt Enhancement" sign="portrait_ai_big_butt" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-waist-slimming" apiName="AI Waist Slimming" sign="portrait_ai_snatched_waist" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-lip-enhancement" apiName="AI Lip Enhancement" sign="portrait_ai_lip_flip" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-fat-filter" apiName="AI Fat Filter" sign="portrait_ai_fat" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/editing/ai-eyeshadow" apiName="AI Eyeshadow Try-On" sign="portrait_ai_eyeshadow" />

        <QueryingCreditsTableRow rowSpan={1} category="Portrait Enhance" href="/docs/ai-portrait/enhance/try-on-clothes-refiner" apiName="Try on Clothes Refiner" sign="portrait_try_on_clothes_refiner" />

        <QueryingCreditsTableRow rowSpan={7} category="Portrait Analysis" href="/docs/ai-portrait/analysis/face-key-points" apiName="Facial Landmarks" sign="portrait_facial_keypoints" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/skin-analysis" apiName="Skin Analyze" sign="portrait_skin_analysis_basic" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/skin-analysis-advanced" apiName="Skin Analyze Advanced" sign="portrait_skin_analysis_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/skin-analysis-pro" apiName="Skin Analyze Pro" sign="portrait_skin_analysis_professional" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/face-analyzer" apiName="Face Analyzer" sign="portrait_face_analyzer" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/face-analyzer-advanced" apiName="Face Analyzer Advanced" sign="portrait_face_analyzer_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-portrait/analysis/ai-face-rating" apiName="AI Face Rating" sign="portrait_ai_face_rater" />
      </tbody>
    </table>
  </Tab>

  <Tab title="AI IMAGE">
    <table>
      <thead className="border p-2">
        <tr>
          <th className="border p-2">Category</th>
          <th className="border p-2">Name</th>
          <th className="border p-2">Unique Identification</th>
        </tr>
      </thead>

      <tbody>
        <QueryingCreditsTableRow rowSpan={6} category="Image Effects" href="/docs/ai-image/effects/ai-anime-generator" apiName="AI Cartoon Generator" sign="image_ai_cartoon_generator" />

        <QueryingCreditsTableRow href="/docs/ai-image/effects/image-colorization" apiName="AI Photo Colorize" sign="image_coloring" />

        <QueryingCreditsTableRow href="/docs/ai-image/effects/image-style-conversion" apiName="Photo to Painting" sign="image_style_transfer" />

        <QueryingCreditsTableRow href="/docs/ai-image/effects/photo-to-line-art" apiName="Photo to Coloring Page" sign="image_line_art" />

        <QueryingCreditsTableRow href="/docs/ai-image/effects/photo-to-emoji-grid" apiName="AI Emoji Generator" sign="image_generate_emoji" />

        <QueryingCreditsTableRow href="/docs/ai-image/effects/ai-photography" apiName="AI Photography" sign="image_photography" />

        <QueryingCreditsTableRow rowSpan={12} category="Image Editing" href="/docs/ai-image/editing/image-cropping" apiName="AI Image Cropping" sign="image_cropping" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/intelligent-composition" apiName="Intelligent Composition" sign="image_intelligent_composition" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/photo-retouching" apiName="Photo Retouch" sign="image_photo_editing" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/image-invisible-image-watermark" apiName="Image Invisible Picture Watermark" sign="image_invisible_image_watermark" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/image-invisible-text-watermarking" apiName="Image Invisible Text Watermark" sign="image_invisible_text_watermark" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/remove-objects" apiName="Remove Objects" sign="image_remove_objects" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/remove-objects-advanced" apiName="Remove Objects Advanced" sign="image_remove_objects_advanced" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/remove-objects-pro" apiName="Remove Objects Pro" sign="image_remove_objects_pro" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/ai-object-replacer" apiName="AI Object Replacer" sign="image_ai_object_replacer" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/ai-image-extender" apiName="AI Image Extender" sign="image_ai_image_extender" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/ai-nail-art" apiName="AI Nail Art" sign="image_fingernails" />

        <QueryingCreditsTableRow href="/docs/ai-image/editing/ai-nail-art-pro" apiName="AI Nail Art Pro" sign="image_fingernails_pro" />

        <QueryingCreditsTableRow rowSpan={6} category="Image Enhancement" href="/docs/ai-image/enhance/image-defogging" apiName="Image Dehaze" sign="image_dehazing" />

        <QueryingCreditsTableRow href="/docs/ai-image/enhance/image-lossless-enlargement" apiName="Image Upscaler" sign="image_lossless_enlargement" />

        <QueryingCreditsTableRow href="/docs/ai-image/enhance/stretch-image-recovery" apiName="Stretched Image Restoration" sign="image_distortion_correction" />

        <QueryingCreditsTableRow href="/docs/ai-image/enhance/image-sharpness-enhancement" apiName="Image Sharpness Enhancement" sign="image_clarity_enhancement" />

        <QueryingCreditsTableRow href="/docs/ai-image/enhance/image-contrast-enhancement" apiName="Image Contrast Enhancement" sign="image_contrast_enhancement" />

        <QueryingCreditsTableRow href="/docs/ai-image/enhance/image-color-enhancement" apiName="Image Color Enhancement" sign="image_color_enhancement" />

        <QueryingCreditsTableRow rowSpan={2} category="Image Scoring" href="/docs/ai-image/rating/image-composition-aesthetics-scoring" apiName="Image Composition Aesthetics Score" sign="image_composition_aesthetics_rating" />

        <QueryingCreditsTableRow href="/docs/ai-image/rating/image-exposure-score" apiName="Image Exposure Score" sign="image_exposure_rating" />
      </tbody>
    </table>
  </Tab>

  <Tab title="AI BACKGROUND REMOVAL">
    <table>
      <thead className="border p-2">
        <tr>
          <th className="border p-2">Category</th>
          <th className="border p-2">Name</th>
          <th className="border p-2">Unique Identification</th>
        </tr>
      </thead>

      <tbody>
        <QueryingCreditsTableRow rowSpan={5} category="General" href="/docs/ai-cutout/general/universal-background-removal" apiName="Universal Background Removal" sign="cutout_general_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/general/hd-universal-background-removal" apiName="HD Universal Background Removal" sign="cutout_hd_general_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/general/food-background-removal" apiName="Food Background Removal" sign="cutout_food_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/general/commodity-background-removal" apiName="Product Background Removal" sign="cutout_product_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/general/apparel-background-removal" apiName="Costume Background Removal" sign="cutout_clothing_background_removal" />

        <QueryingCreditsTableRow rowSpan={4} category="Portrait" href="/docs/ai-cutout/portrait/portrait-background-removal" apiName="Human Background Removal" sign="cutout_human_body_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/portrait/hd-portrait-background-removal" apiName="HD Human Background Removal" sign="cutout_hd_human_body_background_removal" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/portrait/avatar-extraction" apiName="Head Extraction" sign="cutout_avatar_extraction" />

        <QueryingCreditsTableRow href="/docs/ai-cutout/portrait/hairstyle-extraction" apiName="Hairstyle Extraction" sign="cutout_hair_extraction" />
      </tbody>
    </table>
  </Tab>
</Tabs>


## OpenAPI

````yaml GET /api/common/query-credits
openapi: 3.0.0
info:
  title: AILabAPI
  description: >-
    [<b>AILabTools</b>](https://www.ailabtools.com) is an advanced tool that
    offers a vast array of simple and flexible API endpoints to suit your
    specific needs. With just one [<b>API
    KEY</b>](https://www.ailabtools.com/doc/get-api-key), you can easily call
    any of the endpoints and integrate them quickly into your application or
    workflow, allowing for smooth and efficient operations.


    [<b>AILabTools</b>](https://www.ailabtools.com) is continuously evolving,
    and you can anticipate even more API endpoints being added in the future,
    further enhancing its capabilities and usefulness for your artificial
    intelligence and machine learning requirements.
  version: 1.0.0
servers:
  - url: https://www.ailabapi.com
    description: Production server
security:
  - apiKeyAuth: []
tags:
  - name: AI IMAGE
  - name: AI IMAGE > Image Enhancement
  - name: AI IMAGE > Image Effects
  - name: AI IMAGE > Image Editing
  - name: AI IMAGE > Image Scoring
  - name: AI BACKGROUND REMOVAL
  - name: AI BACKGROUND REMOVAL > Portrait
  - name: AI BACKGROUND REMOVAL > General
  - name: AI PORTRAIT
  - name: AI PORTRAIT > Portrait Effects
  - name: AI PORTRAIT > Portrait Enhance
  - name: AI PORTRAIT > Portrait Editing
  - name: AI PORTRAIT > Portrait Analysis
  - name: AI COMMON
paths:
  /api/common/query-credits:
    get:
      tags:
        - AI COMMON
      summary: Querying Credits
      description: >-
        Query API credit balances, purchased credits, warning thresholds, and
        update times for each API identifier.
      responses:
        '200':
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/PublicResponseFields'
                  - type: object
                    required:
                      - data
                    properties:
                      data:
                        type: array
                        description: Credit entries grouped by API.
                        items:
                          type: object
                          required:
                            - unique_sign
                            - name
                            - balance
                            - total
                            - last_recharge_balance
                            - balance_warning
                            - first_buy_time
                            - last_update_time
                          properties:
                            unique_sign:
                              type: string
                              description: >-
                                Unique Identification. See [Unique
                                Identification](/docs/ai-common/querying-credits/api#api-identifier).
                            name:
                              type: string
                              description: Name.
                            balance:
                              type: number
                              format: float
                              description: Current credit balance.
                            total:
                              type: number
                              format: float
                              description: Total purchased credits.
                            last_recharge_balance:
                              type: number
                              format: float
                              description: Credit balance after the last recharge.
                            balance_warning:
                              type: number
                              format: float
                              description: Low-balance alert threshold.
                            first_buy_time:
                              type: integer
                              format: int64
                              description: Unix timestamp of the first purchase.
                            last_update_time:
                              type: integer
                              format: int64
                              description: Unix timestamp of the last balance update.
              example:
                request_id: ''
                log_id: ''
                error_detail:
                  code: ''
                  code_message: ''
                  message: ''
                data:
                  - unique_sign: ''
                    name: ''
                    balance: 0
                    total: 0
                    last_recharge_balance: 0
                    balance_warning: 0
                    first_buy_time: 0
                    last_update_time: 0
          description: Success
components:
  schemas:
    PublicResponseFields:
      type: object
      required:
        - request_id
        - log_id
        - error_detail
      properties:
        request_id:
          type: string
          description: Request ID for debugging.
        log_id:
          type: string
          description: Log ID for debugging.
        error_detail:
          $ref: '#/components/schemas/ErrorDetail'
    ErrorDetail:
      type: object
      required:
        - code
        - code_message
        - message
      properties:
        code:
          type: string
          description: >-
            Error Code. See [Error
            Codes](/docs/response-description#error-codes).
        code_message:
          type: string
          description: Error summary.
        message:
          type: string
          description: Detailed error message.
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: ailabapi-api-key
      description: API Key for authentication

````