This documentation is actively being updated as we further develop our API.

​
Welcome to the Ace API

The Ace AI API allows developers to interact with AI-related services to:

  • Generate synthetic data.
  • Upload and download datasets using signed URLs.
  • Perform specific tasks with custom AI prompts.
  • (Planned) Perform data refinement and other advanced data tasks.

These services are designed to handle client requests efficiently. Additionally, the API can communicate with backend services (including Kafka) for scalable and decoupled processing of tasks like data generation and model training.

All data will be subject to scrutiny from our team of domain-expert human evaluators.

​
Core Functionality

The Ace AI API is organized into several key sections:

  1. Authentication: Sign up, log in, and manage your user profile.
  2. Synthetic Data: Upload original datasets, generate synthetic data, and download the results.
  3. Generative AI (GenAI): Upload data for custom AI tasks and retrieve analytical results.
  4. Evaluator: Retrieve, create, and update evaluation data, as well as manage comments on evaluation entries.
  5. Editor: Retrieve, create, and update editing tasks for enhanced data processing.

​
Authentication

Authentication is the foundation of our API. The following endpoints help you register, log in, and manage your profile:

  • POST /auth/v1/signup: Register a new user account.
  • POST /auth/v1/login: Log in and receive a session token (returned as both an HttpOnly cookie and a Bearer token).
  • PATCH /auth/v1/profile/{username}: Update your user profile with expertise, bio, education, and experiences.

​
Base Endpoints

Below is a quick list of the core API endpoints. For complete details—including request parameters, response formats, and usage examples—please refer to the dedicated pages in the Endpoints section.

RouteMethodDescription
/GETDefault route. Returns “hello world!” as a simple health check.
/auth/v1/signupPOSTRegisters a new user account.
/auth/v1/loginPOSTAuthenticates a user and returns a session token.
/auth/v1/profile/{username}PATCHUpdates a user profile.
/synthetic/v1/uploadURLPOSTGenerates a signed URL for securely uploading datasets.
/synthetic/v1/downloadURLPOSTGenerates a signed URL for securely downloading data.
/synthetic/v1/generatePOSTRequests the creation of synthetic data based on an existing dataset.
/genAI/v1/uploadURLPOSTGenerates a signed URL for uploading data for GenAI tasks.
/genAI/v1/downloadURLPOSTGenerates a signed URL for downloading data used or produced by GenAI tasks.
/genAI/v1/performPOSTSubmits a custom prompt for AI-based analysis of uploaded data.
/evaluator/v1/evaluation-dataGETRetrieves evaluation data with filtering options (username, status, etc.).
/evaluator/v1/evaluation-dataPOSTCreates a new evaluation data entry.
/evaluator/v1/evaluation-data/randomGETRetrieves a random evaluation data entry based on evaluator username.
/evaluator/v1/evaluation-data/{id}PATCHUpdates evaluation data fields (tags, status, data, rating) for an entry.
/evaluator/v1/evaluation-data/commentGETRetrieves comments for a specific evaluation data entry.
/evaluator/v1/evaluation-data/commentPOSTAdds a new comment to an evaluation data entry.
/evaluator/v1/evaluation-data/comment/{id}PATCHUpdates an existing comment on an evaluation data entry.
/evaluator/v1/evaluation-data/comment/{id}DELETEDeletes a comment from an evaluation data entry.
/editor/v1/tasks/randomGETRetrieves a random editing task for a specified task type.
/editor/v1/tasks/{taskType}POSTCreates a new editing task of the specified type.
/editor/v1/tasks/{taskType}/{id}PATCHUpdates an existing editing task.

This introduction provides a high-level overview of the API, its capabilities, and how to get started. For detailed information about each endpoint—including request parameters, response formats, and examples—please see the dedicated pages in the Endpoints section.