ImageCategoriesConverter
Classify images into hierarchical category taxonomies using a vision-language model. Supports standard taxonomies like IAB Content Taxonomy, Google Product Categories, and custom category trees with multi-label classification and confidence scoring.
How It Works
Upload an image or provide a URL to the Mixpeek API.
A vision-language model analyzes the image content and composition.
The image is scored against each category in your selected taxonomy.
Multi-label classification assigns all relevant categories above the confidence threshold.
Hierarchical category paths are returned with confidence scores at each level.
Code Examples
import os, requests
API = "https://api.mixpeek.com"
H = {"Authorization": f"Bearer {os.environ['MIXPEEK_API_KEY']}",
"X-Namespace": os.environ["NAMESPACE_ID"]}
# 1. a bucket, with a schema that declares the field you will send
bucket = requests.post(f"{API}/v1/buckets", headers=H, json={
"bucket_name": "image-inputs",
"bucket_schema": {"properties": {"image": {"type": "image"}}},
}).json()
# 2. land the file as an object. the URL goes in data, on the blob
requests.post(f"{API}/v1/buckets/{bucket['bucket_id']}/objects", headers=H, json={
"key_prefix": "run-1",
"blobs": [{"property": "image", "type": "image",
"data": "https://example.com/photo.jpg"}],
})
# 3. a collection over that bucket, running the extractor
collection = requests.post(f"{API}/v1/collections", headers=H, json={
"collection_name": "image-to-categories",
"source": {"type": "bucket", "bucket_ids": [bucket["bucket_id"]]},
"feature_extractor": {"feature_extractor_name": "image_extractor", "version": "v1"},
}).json()
# 4. run extraction over the bucket
requests.post(f"{API}/v1/buckets/{bucket['bucket_id']}/batches", headers=H, json={
"collection_ids": [collection["collection_id"]],
"auto_submit": True,
})
# 5. read the output
docs = requests.get(
f"{API}/v1/collections/{collection['collection_id']}/documents", headers=H
).json()
print(docs)Use Cases
Supported Input Formats
Quick Info
Run it over a library
Mixpeek runs this conversion as a pipeline over a whole library in your object storage, with the output landing as queryable documents. It is not a single-file converter.
Frequently Asked Questions
Related Converters
Image to Embeddings
Convert images into dense vector representations using state-of-the-art vision models. Embeddings capture semantic visual features and can be used for similarity search, clustering, and cross-modal retrieval.
Image to Tags
Automatically classify images and generate a ranked list of semantic tags. Tags are drawn from standard taxonomies (IAB, custom) or generated freely, each with a confidence score.
Image to Description
Generate rich, multi-sentence descriptions of images covering composition, subjects, colors, mood, and context. Ideal for detailed content cataloging, creative writing prompts, and advanced search indexing.
Image to Metadata
Extract comprehensive technical and semantic metadata from images. Returns EXIF data, camera settings, GPS coordinates, and AI-generated semantic tags including detected objects, scene type, dominant colors, and content categories.
Ready to convert image to categories?
Start using the Mixpeek Image to Categories in minutes. Sign up for a free API key and follow the documentation to get started.