Baseline Conceptual A.R.T.I.S.T. API Structure

Over the years working with the media world and having architected an AI system centered around performing content recognition and classification, I think I have come to some clarity on how I might go forward building a more human accessible and maintainable API.   This is currently an exploratory effort.  

An AI system can be complex with terms like HITL, Labeling, Training, Inference, Classification, NLP, OCR, Machine Learning, Neural Networks, and Meta Data Mastering.   It's all a bit intimidating to someone new.   So I currently decided to borrow from the well established Art community to mitigate that issue a bit.   Most people are familiar with the art community terms.  In the art community you have Artists, Curators, Conservators, Critics, and Art Galleries to name a few key concepts in the art community.   The intent is to organize the API in which it makes it easier to navigate and understand.     

The below API design is a high level entry point design and doesn't cover the objects and functions under them (Yet):

Entry Points:

• Gallery - The Gallery is where people go to see the Art.  
• This API entry point is where the UI will search and access all data, Video, and Images.   
• Critic - The critic evaluates a piece of art based on various criteria.   
• This API entry point is where the UI can enable the audience to rate a video or manage AI to score the video.   There can be many types of ratings and scores.   Social Rating, Content Rating, and Diversity Scoring to name a few.
• Conservator - The Conservator provides the caring, reconstruction/preservation, and safe keeping of a piece of art.   
• This API entry point is where labeling, training, inferance, and classification is performed by people or AI to "Reconstruct" the information that was lost or inaccessible by the originator of the video (Which is always the case).  The resulting inferred information enables the video content to be indexed and easily searchable, accessible, and critiqued.  
• Curator - The Curator identifies, sources, and collects pieces of art for an Art Gallery or private art collector.  
• This API entry point is where the data mastering, sourcing, & capturing a video is performed.

Each entry point has its own objects and functions relating to its area.   They will contain the necessary C.R.U.D. functionality along with the appropriate report access, process execution & state management.  Please refer to the data model in previous post to get an idea what those objects and functions might be.

API Layout

This is first take on laying out a clean organization of lower levels of the api before the actual function.  Its not complete and I will let your imagination to expand on it.

Additionally, rather than cluttering up the diagram below with a bunch of C.R.U.D., I am assuming they exist where appropriate.   I will be modifying this as time goes when my thoughts on this becomes clearer.