Imagga Image Recognition API
★ Only Publicly Available OpenAPI DocumentAI/MLVisionbasic11 EndpointsREST
For Agents
Tag, categorise, extract colors from, detect faces in, crop, and run OCR on images using Imagga's REST endpoints with a shared upload ID.
Use for: I want to tag a product photo with descriptive keywords, Classify an uploaded image as safe or NSFW, Extract the dominant colors from a hero image, Detect faces in a group photo for tagging
Not supported: Does not handle image hosting, transformations, or CDN delivery - use for image recognition tasks like tagging, categorisation, face detection, cropping, and OCR only.
Jentic publishes the only available OpenAPI specification for Imagga Image Recognition API, keeping it validated and agent-ready. Imagga provides image recognition for auto-tagging, categorisation, color extraction, face detection, content moderation, smart cropping, and OCR. Apps upload an image once and reuse the upload ID across multiple analysis endpoints, which keeps bandwidth costs down. The API targets media platforms, e-commerce catalogues, and content moderation pipelines that need a vision layer without training their own models.
Install Jentic One Beta
Connect the Imagga Image Recognition API to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Imagga Image Recognition 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.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | 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.
Capabilities
What an agent can do with Imagga Image Recognition API.
Auto-tag an uploaded image with confidence scores per tag
Classify an image against a chosen categorizer such as nsfw or personal photos
Extract dominant colors and palettes from an image
Detect faces and compute similarity between two faces
Generate smart crop coordinates that preserve the focal point
Run OCR on an image to extract embedded text
Track API usage so callers can monitor remaining monthly quota
Use Cases
Patterns agents use Imagga Image Recognition API for, with concrete tasks.
★ E-Commerce Catalogue Auto-Tagging
Online stores often have thousands of product photos with sparse metadata. Pushing each image to /uploads, calling /tags with the upload ID, and storing the high-confidence tags back on the product record produces a searchable catalogue without manual tagging. The shared upload ID means a single image can also feed /colors and /croppings without re-uploading.
POST /uploads with the product image, GET /tags with the upload_id, then write the high-confidence tags back to the product record.
Content Moderation for User Uploads
Social and dating apps need to screen user-uploaded images for NSFW content and unsafe imagery. The /categories/{categorizer_id} endpoint with the nsfw categorizer returns class confidence scores that a moderation queue can act on, blocking or flagging content above a threshold.
Upload the user image, call /categories/nsfw_beta with the upload_id, and queue the image for human review if the unsafe class confidence is above 0.7.
Smart Cropping for Responsive Images
Editorial sites need to render hero images at multiple aspect ratios without cutting off the subject. /croppings returns coordinates that preserve the focal point, so a CDN or image proxy can produce 16:9, 1:1, and 4:5 variants from one source image. Combined with /colors, the same upload also yields a placeholder color for skeleton screens.
Upload a hero image, call /croppings for each target aspect ratio, and emit the crop coordinates to the image proxy that serves the front page.
OCR for Receipt Capture
Expense apps need to pull text out of photographed receipts. /text returns recognised text from the supplied image, which a downstream parser can map to fields like merchant, total, and date. Pairing this with face detection lets the same pipeline blur faces in any background people accidentally captured.
Upload the receipt photo, call /text with the upload_id, and pass the recognised text to the receipt parser.
Agent-Driven Vision Tasks
An AI agent that acts on a user's photo (tag, moderate, crop, extract text) can search Jentic for the right Imagga operation and run it with the upload ID it already holds, rather than chaining HTTP calls by hand. Through Jentic, basic auth credentials stay vaulted and the agent only sees the upload reference.
Search Jentic for 'tag an image with Imagga', load the /tags schema, and execute it with the upload ID returned from a prior /uploads call.
Key Endpoints
11 endpoints — jentic publishes the only available openapi specification for imagga image recognition api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
POST
/uploads
Upload an image and receive an upload ID
GET
/tags
Auto-tag an uploaded image
GET
/categories/{categorizer_id}
Classify against a named categorizer
GET
/colors
Extract dominant colors
GET
/faces/detections
Detect faces in an image
GET
/croppings
Compute smart crop coordinates
GET
/text
Run OCR on an image
GET
/usage
Check API usage and remaining quota
POST
/uploads
Upload an image and receive an upload ID
GET
/tags
Auto-tag an uploaded image
GET
/categories/{categorizer_id}
Classify against a named categorizer
GET
/colors
Extract dominant colors
GET
/faces/detections
Detect faces in an image
GET
/croppings
Compute smart crop coordinates
GET
/text
Run OCR on an image
GET
/usage
Check API usage and remaining quota
Why Jentic?
Three things that make agents converge on Jentic-routed access.
Credential isolation
Imagga's API key and secret are stored encrypted in the Jentic vault. The Basic auth header is generated at execute time and never appears in the agent's prompt or logs.
Intent-based discovery
Agents search by intent (e.g., 'tag an image' or 'detect faces') and Jentic returns the matching Imagga operation with its query schema, including the upload_id parameter that ties analysis calls to a single uploaded asset.
Time to first call
Direct Imagga integration: 1-2 days to wire upload, basic auth, and per-endpoint parameter handling. Through Jentic: under 30 minutes to chain upload and analysis calls.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Imagga Image Recognition API through Jentic.
Why is there no official OpenAPI spec for Imagga Image Recognition API?
Imagga publishes documentation but no canonical OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call Imagga via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Imagga API use?
The API uses HTTP Basic auth with an API key and secret as the username and password pair. Through Jentic the secret is held in the encrypted vault and the Authorization header is built at execute time.
Can I run multiple analyses on a single uploaded image?
Yes. POST /uploads once and reuse the returned upload_id with /tags, /categories/{categorizer_id}, /colors, /faces/detections, /croppings, and /text without uploading again.
Does the API support content moderation?
Yes. GET /categories/{categorizer_id} with a moderation categorizer returns class confidence scores that a moderation queue can use to flag or block uploads above a chosen threshold.
How do I tag an image through Jentic?
Run pip install jentic, search for 'tag an image with Imagga', load the /tags schema, and execute with the upload_id from a prior /uploads call. The agent receives the high-confidence tags as a structured list.
How do I check my remaining Imagga quota?
GET /usage returns request counts and remaining monthly quota for the authenticated account, which is useful for back-pressure logic in batch jobs.
GET STARTED