Guide baseline: v0.9.11
Image Alt Text
Generate draft descriptions with the workspace’s configured vision provider, then review them in the image’s actual context.
Choose the provider and context
The vision lane can use a local or cloud provider; no single model is universal. An enabled remote provider can receive the image and supplied context. Confirm the workspace provider authorization and institutional data policy before submitting sensitive material. Self-hosting alone does not establish local-only processing.
Supported inputs and batches
The single-image route accepts JPG/JPEG, PNG, GIF, BMP and WebP with upload/content validation. The configured MAX_FILE_SIZE_IMAGE default is 10 MiB per image. POST /education/image/batch-alt-text accepts files fields with at most 50 images per request; inspect each result and its error instead of treating the batch success flag as every image succeeding.
Review meaning before using the result
Use the image’s purpose in the surrounding material to decide what the alternative should convey. Check chart values, labels, relationships and technical terminology against the source. Complex graphics may need a longer description or data table. A decorative-image suggestion is a review decision, and generated descriptions can be wrong.
Authenticated API usage
Use your deployment URL and an authorized API key. The localhost URL below is for a locally running API.
curl --fail --silent --show-error \
-H "Authorization: Bearer $AELIRA_API_KEY" \
-F "[email protected]" \
"http://localhost:8000/education/image/alt-text?context=Statistics%20lecture&educational_context=true"This endpoint is synchronous: a successful response contains success, file_name, alt_text, long_description, image_type, educational_value, contains_text, text_content, image_metadata, inference_time_ms and model. context and educational_context are query parameters; file is multipart. Generation failure is an error, not reviewed alt text.
API authentication, lifecycle and errorsEvidence and review
This guide describes released Core source; availability in a hosted deployment depends on its release and configuration. Review output before publishing it.