Skip to main content
POST
/
api
/
image
/
effects
/
ai-anime-generator
AI Cartoon Generator
curl --request POST \
  --url https://www.ailabapi.com/api/image/effects/ai-anime-generator \
  --header 'Content-Type: multipart/form-data' \
  --header 'ailabapi-api-key: <api-key>' \
  --form task_type=async \
  --form 'index=<string>' \
  --form image=@example-file
{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_code_str": "",
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "task_type": "",
  "task_id": ""
}

​
Request

  • URL: https://www.ailabapi.com/api/image/effects/ai-anime-generator
  • Method: POST
  • Content-Type: multipart/form-data

​
Image requirements

  • Image format: JPEG PNG JPG BMP WEBP
  • Image size: No more than 10 MB.
  • The input image dimensions should be greater than or equal to 256x256 pixels and less than or equal to 5760x3240 pixels. The short side of the output image will be 1536 pixels. If the ratio of the long side to the short side of the input image is less than or equal to 1.5:1, the original aspect ratio will be maintained. If this ratio is greater than 1.5:1, adaptive cropping will be applied to achieve an output aspect ratio of 1.5:1.

​
Headers

FieldRequiredTypeDescription
ailabapi-api-keyYESstringApplication API KEY. Get API KEY

​
Body

FieldRequiredTypeScopeDefaultDescription
task_typeYESstringasyncasync“async: Asynchronous tasks.
imageYESfile
indexYESinteger0, 1, 2, 3, 4, 5, 6, 7, 800`: Vintage Comic.`, 1: 3D Fairy Tale., 2`: Two-dimensional (2D).`, 3: Refreshing and Elegant., 4`: Future Technology.`, 5: Traditional Chinese Painting Style., 6`: General in a Hundred Battles.`, 7: Colorful Cartoon., “8: Graceful Chinese Style.

​
Response

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.

​
Public Response Fields

Viewing Public Response Fields and Error Codes

​
Business Response Fields

FieldTypeScopeDescription
task_typestringasyncTask Type. “async: Asynchronous tasks.
task_idstringAsynchronous task ID.
Please use this field when calling the Querying Async Task Results API.

​
Response Example

{
  "request_id":     "",
  "log_id":         "",
  "error_code":     0,
  "error_msg":      "",
  "error_detail":   {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  },
  "task_type":      "",
  "task_id":        ""
}
This API is asynchronous, please keep task_id and call Querying Async Task Results to get the final results.Asynchronous task results are valid for 24 hours. It is recommended that asynchronous task results be queried every 5 seconds.

​
Querying Async Task Results Response

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.

​
Public Response Fields

Viewing Public Response Fields and Error Codes

​
Business Response Fields

FieldTypeScopeDescription
task_statusinteger0, 1, 2Asynchronous task status. 0`: The task is queued.` 1: Asynchronous processing. “2: Processing was successful.
dataobjectThe content of the result data returned.
+result_urlstringResult URL address.
The URL address is a temporary address, valid for 24 hours, and will not be accessible after it expires. If you need to save the file for a long time or permanently, please visit the URL address within 24 hours and download the file to your own storage space.

​
Response Example

{
  "error_code":     0,
  "error_msg":      "",
  "error_detail":   {
    "status_code":  200,
    "code":         "",
    "code_message": "",
    "message":      ""
  },
  "task_status":    0,
  "data":           {
    "result_url": ""
  }
}

​
Sample Code

[👉 Online Experience 👈(https://www.ailabtools.com/image-ai-cartoon-generator-example)]If you’d like to see the actual effects, please visit the experience page for a trial.

Authorizations

​
ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
​
task_type
string

Task Type.

Example:

"async"

​
image
file
​
index
string

Cartoon effect. <li>0: Vintage Comic.</li> <li>1: 3D Fairy Tale.</li> <li>2: Two-dimensional (2D).</li> <li>3: Refreshing and Elegant.</li> <li>4: Future Technology.</li> <li>5: Traditional Chinese Painting Style.</li> <li>6: General in a Hundred Battles.</li> <li>7: Colorful Cartoon.</li> <li>8: Graceful Chinese Style.</li>

Response

200 - application/json

Success

The response is of type object.