openapi: 3.0.0
servers:
  - url: https://prod.api.market/api/v1/ailabtools/change-facial-expressions
info:
  title: Change Facial Expressions API
  version: 1.12.0
  description: Transform facial expressions in images with advanced editing
    technology, enabling smiles, pouts, frowns, and more with our API.
paths:
  /portrait/editing/emoticonedit:
    post:
      tags:
        - AI PORTRAIT > Portrait Editing
      summary: Change Facial Expressions
      operationId: 7c4a11dfaa4b971435337b7a2f379884
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              required:
                - image_target
                - service_choice
              properties:
                image_target:
                  description: "<li>Image format: `JPEG` `JPG` `PNG`</li> <li>Image size: No more
                    than 5 MB.</li> <li>Image resolution: Less than
                    4096x4096px.</li>"
                  type: file
                service_choice:
                  description: "Expression type. <li>`0`: Big laugh.</li> <li>`1`: Pouting.</li>
                    <li>`2`: Feel sad.</li> <li>`3`: Smile.</li> <li>`10`:
                    Dimple Smile.</li> <li>`11`: Pear Dimple Smile.</li>
                    <li>`12`: Big Grin.</li> <li>`13`: Standard Grin.</li>
                    <li>`14`: Cool Pose.</li> <li>`15`: Sad.</li> <li>`16`:
                    Forced Smile.</li> <li>`100`: Opening eyes.</li>"
                  type: integer
                  enum:
                    - 0
                    - 1
                    - 2
                    - 3
                    - 10
                    - 11
                    - 12
                    - 13
                    - 14
                    - 15
                    - 16
                    - 100
              type: object
      responses:
        "200":
          description: ""
          content:
            application/json:
              schema:
                allOf:
                  - properties:
                      data:
                        type: object
                        allOf:
                          - properties:
                              image:
                                description: The result image, returning the Base64 encoding of the image.
                                type: string
                            type: object
                    type: object
                  - $ref: "#components/schemas/commonResponses"
        "400":
          description: Bad Request
        "401":
          description: Unauthorized
        "403":
          description: Forbidden
        "404":
          description: Not Found
        "405":
          description: Method Not Allowed
        "409":
          description: Conflict
        "410":
          description: Gone
        "413":
          description: Payload Too Large
        "415":
          description: Unsupported Media Type
        "422":
          description: Unprocessable Entity
        "429":
          description: Too Many Requests
        "500":
          description: Internal Server Error
        "502":
          description: Bad Gateway
        "503":
          description: Service Unavailable
        "504":
          description: Gateway Timeout
    parameters:
      - description: API.market API Key
        in: header
        name: x-api-market-key
        value: Please Login/Signup to get an API Key
        required: true
        schema:
          type: string
components:
  schemas:
    commonResponses:
      properties:
        request_id:
          description: Request ID. <li>If there is a problem that cannot be located, this
            field can be sent to technology for problem location.</li>
          type: string
        log_id:
          description: Log ID. <li>If there is a problem that cannot be located, this
            field can be sent to technology for problem location.</li>
          type: string
        error_code:
          description: "Status code. <li>When HTTP Status is 200: error_code=0; otherwise
            exactly the same as HTTP Status.</li>"
          type: integer
        error_detail:
          type: object
          allOf:
            - properties:
                status_code:
                  description: Status Code.
                  type: integer
                code:
                  description: Error Code.
                  type: string
                code_message:
                  description: The information represented by the Error Code(`code`).
                  type: string
                message:
                  description: Supplementary information for the `code_message` field.
                  type: string
              type: object
        error_msg:
          description: Error message.
          type: string
      type: object
security: {}
tags:
  - name: face-tools
    description: Operations related to face-tools
  - name: background-removal
    description: Operations related to background-removal
  - name: image-upscaling
    description: Operations related to image-upscaling
