ImageTagsConverter
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.
How It Works
Upload an image or provide a URL.
A vision model identifies objects, scenes, and attributes.
Each detection is mapped to a tag with a confidence score.
Tags are ranked by relevance and filtered by your threshold.
The tag list is returned with optional taxonomy mapping.
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-tags",
"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 Caption
Generate natural-language captions for images using a vision-language model. Produces concise, descriptive sentences suitable for alt text, content indexing, and accessibility compliance.
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.
Ready to convert image to tags?
Start using the Mixpeek Image to Tags in minutes. Sign up for a free API key and follow the documentation to get started.