README

Welcome to the Kolas.Ai Public API documentation! This repository hosts the OpenAPI 3.1 specification for Kolas.Ai's public API, making it easy for developers to integrate Kolas.Ai’s machine learning services into their applications.

Overview

The Kolas.Ai API is designed to classify message categories based on a trained dataset within a configured project. Use this API to accurately categorize messages into types like "Neutral", "Insult", "Spam" , etc. We support different languages, including English, Russian, Ukrainian, and we can add any languages by request (message to info@kolas.ai). The API is built on the OpenAPI 3.1 standard, ensuring a consistent and easy-to-use interface.

Key Features

• Predict Message Categories: Use the /predictions/predict endpoint to classify messages based on your project-specific dataset.
• High Accuracy: Predictions include probability scores, giving you confidence in the classification results.
• OAuth2 Authentication: Secure access via OAuth2 client credentials flow.

Usage

The Kolas.Ai API follows the OpenAPI 3.1 standard, which enables easy exploration and integration with various tools. To get started:

1. Create a new account on the Kolas.Ai platform.
2. Create a new project Clean Talk and configure your datasets.
3. Authentication: Obtain an access token using OAuth2 client credentials.
4. Make Predictions: Send a POST request to /predictions/predict with your projectId and messages.
5. Receive Predictions: Retrieve predicted categories and their probabilities in the API response.

Authentication

This API uses OAuth2 client credentials for secure access. You’ll need to request a token using your client credentials from the Kolas.Ai platform.

Example Request

Once you have your access token, you can make a request like this:

{
  "projectId": 3457,
  "messages": [
    { "message": "How was your day?" }
  ]
}

Example Response

The response includes predictions and associated probabilities:

{
  "predictions": [
    {
      "categories": ["Neutral", "Insult", "Spam"],
      "prediction": "Neutral",
      "probability": "0.998",
      "message": "How was your day?"
    }
  ]
}

Documentation Links

• Swagger Documentation: Explore the OpenAPI specification.
• Kolas.Ai Platform Documentation: Learn more about configuring projects and using Kolas.Ai’s platform.

License

This API specification is released under the Apache 2.0 License. See the LICENSE for more details.

__

Feel free to explore, test, and integrate Kolas.Ai's API, and reach out with any questions!