# 🌐 ViscribeAI – Extract Data from your Images [![License](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![Documentation Status](https://readthedocs.org/projects/viscribe/badge/?version=latest)](https://docs.viscribe.ai) ViscribeAI is an AI-powered image understanding and analysis API for describing images, extracting structured information, answering visual questions, and comparing images. > 🎁 **Get started with free credits!** Visit [dashboard.viscribe.ai](https://dashboard.viscribe.ai) to sign up and get your API key. --- ## 🚀 Features - 🖼️ AI-powered image description, extraction, classification, VQA (Visual Question Answering), and comparison - 📊 Structured JSON responses - 🔍 Detailed logging and error messages - ⚡ Automatic retries and reliability handling - 🔐 Secure API authentication --- ## 📚 Image Endpoints ### 1. Describe Image Generate a natural-language description of an image and optional tags. 📖 Documentation: https://docs.viscribe.ai/features/describe **Use cases:** - Accessibility (alt-text generation) - Content moderation - Search indexing - Caption generation --- ### 2. Classify Image Classify an image into one or more predefined categories. 📖 Documentation: https://docs.viscribe.ai/features/classify **Use cases:** - Product categorization - Content filtering - Scene recognition - Dataset labeling --- ### 3. Visual Question Answering (VQA) Ask questions about image content and receive direct answers. 📖 Documentation: https://docs.viscribe.ai/features/ask **Use cases:** - Visual search - Customer support automation - Educational apps - Image investigation tools --- ### 4. Extract Structured Data from Image Extract structured attributes from images such as products, documents, menus, or receipts. 📖 Documentation: https://docs.viscribe.ai/features/extract #### Simple Fields (Recommended) Extract straightforward structured fields from images. **Supported Field Types:** - `text` – Single text value - `number` – Numeric value - `array_text` – List of text values (max 5 items) - `array_number` – List of numeric values (max 5 items) **Use cases:** - Product info scraping - Receipt extraction - Menu parsing - Form digitization --- #### Advanced Schema Extract deeply structured or nested data when higher precision is required. **Use cases:** - Invoice parsing - Multi-field document understanding - Business data automation - OCR pipelines > **Note:** Use either simple fields or an advanced schema per request. --- ### 5. Compare Images Compare two images and return similarities and differences. 📖 Documentation: https://docs.viscribe.ai/features/compare **Use cases:** - Quality assurance - Duplicate detection - Change tracking - Before/after analysis --- ## 📖 Full Documentation https://docs.viscribe.ai --- ## 💬 Support & Feedback - 📧 Email: support@viscribe.ai - 🌟 Feature Requests: https://github.com/ViscribeAI/python-sdk/issues/new --- ## 📄 License This project is licensed under the MIT License. --- ## 🔗 Links - Website: https://viscribe.ai - Documentation: https://docs.viscribe.ai - GitHub: https://github.com/ViscribeAI/python-sdk --- > 🎁 **Get started with free credits!** Visit [dashboard.viscribe.ai](https://dashboard.viscribe.ai) to sign up and get your API key. Made with ❤️ by ViscribeAI