🧾 Request Parameters

Parameter	Type	Required	Description
`file`	`file`	✅ Yes (if `base64_str` is not provided)	The input image file to be processed (must be provided as a file, e.g., .jpg, .png).
`base64_str (≤ 1MB)`	`string`	✅ Yes (if `file` is not provided)	Base64-encoded string of the image file (used when sending image data directly in requests).
`labels`	`string`	✅ Yes	A comma-separated list of labels to classify the image (e.g., "bottle, box; red, blue, purple"). Multiple groups of labels can be separated by a semicolon. Each group represents different categories, and labels can be provided in multiple languages (e.g., "瓶子,盒子; 红色, 蓝色, 紫色").

✅ Successful Response Example

![image](https://aipix.net/static/examples/custom-image-classification.webp)

![image](https://aipix.net/static/examples/custom-image-classification2.webp)

📤 Response Example:

{
  "code": 200,
  "res": [
    [
      {
        "label": "Bottle",
        "score": 0.9985
      },
      {
        "label": "box",
        "score": 0.0014
      }
    ],
    [
      {
        "label": "purple",
        "score": 0.5322
      },
      {
        "label": "red",
        "score": 0.4414
      },
      {
        "label": "blue",
        "score": 0.0261
      }
    ]
  ],
  "response_time": 0.125
}

❌ Error Responses

HTTP Code	JSON `code`	Description
422	422	Invalid input parameters.
429	429	Too many requests or timeout.
500	500	Internal server error.

📉 Error Response Format

{
  "code": <error_code>,
  "msg": "<brief error description>"
}

Example:

{
  "code": 429,
  "msg": "Too many requests."
}

📌 Notes

We strictly protect user privacy and do not store any user data.
We strive to minimize input restrictions (e.g., image size, text length), but excessive input volume may result in 429 or 500 errors.
The service operates at the maximum capacity of our servers, and we dynamically scale infrastructure to handle varying request loads.

📬 Support & Custom Deployment

For questions or support, please reach out to our team using the contact page.

We also offer dedicated server deployment for enterprise clients — a private, standalone environment that includes full API functionality with no request limits.

Pricing is based on the number of servers deployed, with each server serving at maximum throughput.

📩 Contact Us

📚 View Our API List