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.
Get started with Imagga Image Recognition API in minutes using your preferred integration method.
# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
"jentic": {
"url": "https://api.jentic.com/mcp",
"auth": "oauth"
}
}
# Then ask your agent:
"tag an image with Imagga"
# → Jentic returns the GET /events tool with parameter schema, agent executes.What an agent can do with Imagga Image Recognition API 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
GET STARTED
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 document for Imagga Image Recognition API, keeping it validated and agent-ready.
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.
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
Patterns agents use Imagga Image Recognition API 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.
11 endpoints — jentic publishes the only available openapi specification for imagga image recognition api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/uploads
Upload an image and receive an upload ID
/tags
Auto-tag an uploaded image
/categories/{categorizer_id}
Classify against a named categorizer
/colors
Extract dominant colors
/faces/detections
Detect faces in an image
/croppings
Compute smart crop coordinates
/text
Run OCR on an image
/usage
Check API usage and remaining quota
/uploads
Upload an image and receive an upload ID
/tags
Auto-tag an uploaded image
/categories/{categorizer_id}
Classify against a named categorizer
/colors
Extract dominant colors
/faces/detections
Detect faces in an image
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.
Alternatives and complements available in the Jentic catalogue.
Clarifai
Clarifai offers vision models for tagging, moderation, and custom-trained classifiers.
Choose Clarifai when the agent needs to train a custom model on the customer's own image set.
OpenAI
OpenAI's vision-enabled models handle tagging, captioning, and OCR through chat completions.
Choose OpenAI when the same agent flow already uses GPT and wants natural-language outputs rather than per-tag confidence scores.
Cloudinary Upload API
Cloudinary handles upload, transformation, and CDN delivery for the same images Imagga analyses.
Choose Cloudinary when the agent also needs to resize, watermark, and serve the analysed images via CDN.
Specific to using Imagga Image Recognition API 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.
/croppings
Compute smart crop coordinates
/text
Run OCR on an image
/usage
Check API usage and remaining quota