ImageCaptionConverter
Generate natural-language captions for images using a vision-language model. Produces concise, descriptive sentences suitable for alt text, content indexing, and accessibility compliance.
How It Works
Upload an image or provide a URL.
A vision-language model analyzes the image content.
A caption is generated describing the main subjects and actions.
The caption is returned along with a confidence score.
Multiple caption variants can be requested for A/B testing.
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-caption",
"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 Text
Extract all readable text from images using advanced OCR combined with a vision-language model. Handles printed text, handwriting, complex layouts, receipts, signs, and multi-language documents.
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.
Ready to convert image to caption?
Start using the Mixpeek Image to Caption in minutes. Sign up for a free API key and follow the documentation to get started.