Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the MachineTutors AI API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmachinetutors.com%2Fmachinetutors" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmachinetutors.com%2Fmachinetutors" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with MachineTutors AI API.
Classify the dominant subject of an image and return label confidence scores via /classify
Detect bounding boxes and labels for objects in a scene through /detect
Flag adult, violent or otherwise unsafe content with the /moderate endpoint
Run visual similarity search to find matching images in a catalogue using /search
GET STARTED
Generate descriptive product tags from product photos with the /tag endpoint
Patterns agents use MachineTutors AI API for, with concrete tasks.
★ E-Commerce Product Auto-Tagging
Eliminate manual data entry on new product uploads by sending the listing image to /tag and receiving a list of descriptive tags. The endpoint analyses the photo and returns labels suitable for filters, facets and search indexing. Useful for catalogue managers loading hundreds of SKUs where consistent tagging would otherwise require expensive manual labelling.
Send a product photo to POST /tag and persist the returned tags as facet values on the listing record
Content Moderation for User Uploads
Screen images uploaded to a community platform for unsafe content before they reach other users. POST /moderate returns category-level scores so moderation logic can auto-block, queue for review, or publish based on policy. Suitable for marketplaces, social apps and dating sites that cannot rely solely on report-based moderation.
POST the uploaded image to /moderate and route it to the human review queue if any unsafe category score exceeds 0.7
Visual Similarity Search for Catalogues
Power 'find similar items' UX inside an e-commerce or stock-imagery app. POST /search accepts an image and returns the most visually similar items already indexed in the catalogue. The agent can then surface those results as recommendations, dupe candidates or replacement suggestions when a SKU goes out of stock.
Submit a customer photo to POST /search and return the top 5 visually similar SKUs from the indexed catalogue
AI Agent Vision Workflow
Plug computer vision into a wider AI agent flow without managing the MachineTutors API key. Through Jentic the agent searches for the vision operation it needs, loads the input schema for /classify, /detect, /moderate, /search or /tag, and executes with credentials brokered by the vault. Useful for multi-step pipelines where a vision call is one step in a longer chain.
Search Jentic for 'classify objects in an image', load /classify, and execute against a user-supplied image URL
5 endpoints — jentic publishes the only available openapi specification for machinetutors ai api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/classify
Classify objects in an image
/detect
Detect objects with bounding boxes
/moderate
Score image content for safety violations
/search
Visual similarity search
/tag
Auto-tag product imagery
/classify
Classify objects in an image
/detect
Detect objects with bounding boxes
/moderate
Score image content for safety violations
/search
Visual similarity search
/tag
Auto-tag product imagery
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the MachineTutors AI API by hand means sending its API key on each image POST and mapping it across the classify, detect, moderate, search, and tag paths. Through Jentic you install once, import the MachineTutors AI API from the API Directory, store the key once, and your agent calls it.
Permission scoping
You choose which MachineTutors operations the agent may call, so you can limit it to the ones it needs, such as classify and tag, and leave out others like moderate or search unless you add them. The agent only reaches the operations in the set you allow.
Credential isolation
Your MachineTutors key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'classify an image' or 'auto-tag a product photo', and Jentic returns the matching MachineTutors operation with its input schema so the agent calls the right endpoint without consulting docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using MachineTutors AI API through Jentic.
Why is there no official OpenAPI spec for MachineTutors AI API?
MachineTutors does not publish an OpenAPI specification on its developer site. Jentic generates and maintains this spec so that AI agents and developers can call the MachineTutors vision endpoints via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.
What authentication does the MachineTutors AI API use?
The API uses an API key authenticated via the ApiKeyAuth scheme defined in the spec, passed as a request header. Through Jentic the key is stored encrypted in your Jentic One instance, so an agent calls /classify or /moderate with a scoped token instead of handling the raw key.
Can I detect multiple objects per image with MachineTutors?
Yes. POST /detect returns an array of detections with bounding boxes and confidence scores, so a single call can surface every object the model identifies in the supplied image. /classify by contrast returns a single dominant label per image.
What are the rate limits for the MachineTutors AI API?
Per-endpoint rate limits are not defined in the spec; MachineTutors typically enforces them at the account tier set when the API key is issued. Check your account dashboard at machinetutors.com for the limits attached to your key.
How do I moderate images with MachineTutors through Jentic?
Run pip install jentic, search for 'moderate an image', and Jentic surfaces POST /moderate with its input schema. Execute with the image URL or upload, then inspect the returned category scores against your moderation policy thresholds.
Does MachineTutors support video moderation?
The published spec defines only image-based endpoints (/classify, /detect, /moderate, /search, /tag). For video moderation, sample frames from the video and submit each frame to /moderate, or choose a provider such as Imagga that handles video natively.
Can I limit what my agent is allowed to do with the MachineTutors AI API?
Yes. Because Jentic One is self-hosted, your own rules decide which MachineTutors operations and credentials the agent may use, so you allow only the ones it needs. For example, you can permit /classify and /tag while leaving out /detect, /moderate, and /search unless you add them. The agent can only call the operations in the set you have allowed, and it never sees the raw API key.
Know of an official OpenAPI document? Contribute it →
For Agents
Classify, detect objects in, moderate, search and auto-tag images using MachineTutors' five computer vision endpoints.
Use for: I need to classify what is in a product photo, Detect every object visible in an uploaded image, Check whether an image contains adult or violent content, Find visually similar items in our product catalogue
Not supported: Does not handle video analysis, custom model training, image generation, or OCR - use for image classification, detection, moderation, search and tagging only.
Jentic publishes the only available OpenAPI specification for MachineTutors AI API, keeping it validated and agent-ready. MachineTutors is an AI-powered computer vision service that exposes five POST endpoints covering image classification, object detection, content moderation, visual similarity search and product auto-tagging. The API is aimed at e-commerce, content platforms and trust-and-safety workflows that need to apply machine vision to user-supplied imagery.