> ## 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.

# Photo to Painting API

> Photo to Painting API converts photos into cartoon, pencil, oil painting, and other artistic styles with AI.

## Request

* **URL**: `https://www.ailabapi.com/api/image/effects/image-style-conversion`
* **Method**: `POST`
* **Content-Type**: `multipart/form-data`

### Image requirements

* **Image format**: `PNG` `JPG` `JPEG` `BMP`
* **Image size**: No more than 8 MB.
* **Image resolution**: Larger than 10x10px, smaller than 5000x5000px.
* **Image aspect ratio**: Aspect ratio within 4:1.

### Headers

| Field              | Required | Type     | Description                                           |
| :----------------- | :------- | :------- | :---------------------------------------------------- |
| `ailabapi-api-key` | YES      | `string` | Application API KEY. [Get API KEY](/docs/get-api-key) |

### Body

| Field    | Required | Type     | Scope                                                                                           | Description                                                                                                                                                                                                                                                                                                                                                                            |
| :------- | :------- | :------- | :---------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `image`  | YES      | `file`   |                                                                                                 |                                                                                                                                                                                                                                                                                                                                                                                        |
| `option` | YES      | `string` | `cartoon`, `pencil`, `color_pencil`, `warm`, `wave`, `lavender`, `mononoke`, `scream`, `gothic` | ``cartoon`: Cartoon style.` ``pencil`: Pencil style.` ``color_pencil`: Color pencil drawing style.` ``warm`: The style of colorful sugar cube oil painting.` ``wave`: Oil painting style in surfing in Kanagawa.` ``lavender`: Lavender oil painting style.` ``mononoke`: Strange oil painting style.` ``scream`: Scream oil painting style.` \`\`gothic`: Gothic oil painting style.` |

## Response

<Warning>
  **Response Field Handling Flow**

  1. **Handle `Public Response Fields`**

     Parse and validate the `Public Response Fields`, checking the status code or response message to ensure the request is successful and error-free.

  2. **Handle `Business Response Fields`**

     If the `Public Response Fields` are valid and error-free, proceed with processing the business logic in the `Business Response Fields`.
</Warning>

### Public Response Fields

<a href="/docs/response-description" target="_blank">Viewing Public Response Fields and Error Codes</a>

### Business Response Fields

| Field   | Type     | Description           |
| :------ | :------- | :-------------------- |
| `image` | `string` | base64 encoded image. |

### Response Example

```json theme={null}
{
  "request_id":     "",
  "log_id":         "",
  "error_code":     0,
  "error_msg":      "",
  "error_detail":   {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  },
  "image":          ""
}
```


## OpenAPI

````yaml POST /api/image/effects/image-style-conversion
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/image/effects/image-style-conversion:
    post:
      tags:
        - AI IMAGE > Image Effects
      summary: Photo to Painting
      description: >-
        Photo to Painting API converts photos into cartoon, pencil, oil
        painting, and other artistic styles with AI.
      requestBody:
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                image:
                  type: string
                  format: binary
                option:
                  type: string
                  description: >-
                    <li>`cartoon`: Cartoon style.</li> <li>`pencil`: Pencil
                    style.</li> <li>`color_pencil`: Color pencil drawing
                    style.</li> <li>`warm`: The style of colorful sugar cube oil
                    painting.</li> <li>`wave`: Oil painting style in surfing in
                    Kanagawa.</li> <li>`lavender`: Lavender oil painting
                    style.</li> <li>`mononoke`: Strange oil painting style.</li>
                    <li>`scream`: Scream oil painting style.</li> <li>`gothic`:
                    Gothic oil painting style.</li>
      responses:
        '200':
          headers:
            Content-Type:
              schema:
                type: string
                example: application/json
          content:
            application/json:
              schema:
                type: object
              example:
                request_id: ''
                log_id: ''
                error_code: 0
                error_code_str: ''
                error_msg: ''
                error_detail:
                  status_code: 200
                  code: ''
                  code_message: ''
                  message: ''
                image: ''
          description: Success
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: ailabapi-api-key
      description: API Key for authentication

````