Volt
API
API

    Volt AI Avatar API#

    Bring your applications to life with interactive AI avatars powered by custom knowledge bases

    What is Volt API?#

    Volt API is a powerful platform that enables developers to integrate lifelike AI avatars into their web and mobile applications. Our API combines advanced AI technology with customizable knowledge bases to create engaging, conversational experiences that can represent your brand, answer customer questions, and provide interactive support - all through a simple REST API and iframe embedding.

    Why Choose Volt API?#

    šŸŽ­ Realistic AI Avatars
    Choose from a library of professional avatars or use voice-only mode for audio-first experiences.
    🧠 Custom Knowledge Bases
    Train your avatar with your own content - documentation, FAQs, product information, or any domain-specific knowledge.
    šŸŒ Multi-Language Support
    Reach global audiences with support for English, Indonesian, Chinese, and Arabic.
    šŸ”’ Enterprise-Grade Security
    API key authentication, secure token generation, and HTTPS encryption keep your data safe.
    ⚔ Easy Integration
    Get up and running in minutes with simple REST API calls and iframe embedding.
    šŸŽØ Customizable Experience
    Control the user experience with configurable avatars, voices, and knowledge bases.

    Use Cases#

    šŸ›ļø E-Commerce#

    Add a virtual shopping assistant that can answer product questions, provide recommendations, and guide customers through the buying process using your product catalog.

    šŸ„ Healthcare#

    Deploy a HIPAA-compliant virtual receptionist or health information assistant that can answer common questions based on your medical knowledge base.

    šŸŽ“ Education#

    Create interactive tutors or virtual teaching assistants that can explain concepts, answer student questions, and provide personalized learning experiences.

    šŸ’¼ Enterprise Support#

    Build intelligent help desk assistants that can resolve common IT issues, HR questions, or customer support inquiries using your company's knowledge base.

    šŸ¦ Financial Services#

    Deploy virtual financial advisors that can explain products, answer compliance questions, and guide users through complex processes.

    šŸØ Hospitality#

    Create virtual concierges that can answer guest questions, provide recommendations, and assist with bookings based on your property information.

    How It Works#

    ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
    │  Your App       │
    │                 │
    │  1. Request     │──────┐
    │     Token       │      │
    ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜      │
                             │
                             ā–¼
                  ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
                  │   Volt API           │
                  │                      │
                  │  • Authenticate      │
                  │  • Generate Token    │
                  │  • Return URL        │
                  ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
                             │
                             │
                             ā–¼
    ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”
    │  Your App                           │
    │                                     │
    │  2. Embed Avatar via iFrame         │
    │                                     │
    │  ā”Œā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”  │
    │  │                               │  │
    │  │   AI Avatar.                  │  │
    │  │                               │  │
    │  │   "How can I help you?"       │  │
    │  │                               │  │
    │  │   [Powered by Knowledge Base] │  │
    │  │                               │  │
    │  ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜  │
    │                                     │
    ā””ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”€ā”˜
    Step 1: Your backend server requests a secure token from Volt API
    Step 2: Volt API returns a complete embed URL with authentication token
    Step 3: Your frontend embeds the avatar using an iframe
    Step 4: Users interact with the AI avatar in real-time

    Quick Start#

    1. Get Your API Key#

    Sign up at workspace.getvolt.io and obtain your API key from the dashboard.

    2. Create Your Knowledge Base#

    Upload your content (documents, FAQs, web links) to create a custom knowledge base that powers your avatar's responses.

    3. Make Your First API Call#

    4. Embed the Avatar#

    5. Go Live! šŸš€#

    Your AI avatar is now ready to engage with your users!

    Features at a Glance#

    FeatureDescription
    REST APISimple, RESTful API with JSON responses
    Token-Based AuthSecure JWT tokens with 24-hour validity
    Real-Time InteractionLive video/audio streaming with low latency
    Knowledge Base RAGRetrieval-Augmented Generation for accurate responses
    Multi-Modal SupportAvatar + voice or voice-only modes
    CORS ConfigurationBuilt-in origin validation for security
    Mobile ReadyWorks with React Native, iOS, and Android WebViews
    Analytics ReadyTrack usage and conversations for insights

    Code Examples#

    We provide ready-to-use code examples in multiple languages:
    JavaScript/Node.js - For backend API calls
    React - Complete component with hooks
    Python - Flask/Django integration
    React Native - Mobile app embedding
    cURL - Quick testing and debugging
    šŸ“– View Full Integration Guide for complete code examples and implementation details.

    API Endpoint Overview#

    Create Media URL#

    Endpoint: POST /api/auth/create-media-url
    Purpose: Generate a secure, token-authenticated URL for embedding an AI avatar
    Key Parameters:
    email - User identifier
    name - User display name
    origin - Your domain (for CORS)
    avatar_id / voice_id - Avatar or voice selection
    knowledge_base_id - Your knowledge base
    lang_id - Language preference
    Response:
    {
      "success": true,
      "data": {
        "complete_url": "https://avatar.getvolt.io/v2/stream-embed?token=...",
        "token": "eyJhbGc...",
        "url": "https://avatar.getvolt.io/v2/stream-embed"
      }
    }
    šŸ“– Full API Reference for detailed documentation.

    Frequently Asked Questions#

    Can I use my own avatar/character?
    Yes! Enterprise plans support custom avatar creation. Contact our sales team for details.
    What languages are supported?
    Currently: English (en-US), Indonesian (id-ID), Chinese (zh-CN), and Arabic (ar-AE, ar-SA). More languages coming soon!
    How much content can I upload to a knowledge base?
    Knowledge base limits vary by plan. Free tier supports up to 10MB, Pro supports 1GB, and Enterprise has custom limits.
    Can I use this in a mobile app?
    Absolutely! Volt API works great with WebView components in React Native, iOS (WKWebView), and Android.
    How long does it take to set up?
    Most developers have a working integration in under 30 minutes. Creating and training a knowledge base takes 5-15 minutes depending on content size.
    Is there a rate limit?
    Yes, rate limits vary by plan. Free tier has basic rate limiting, while paid plans offer higher limits. See pricing above.

    License#

    The Volt API is proprietary software. See our Terms of Service for usage details.

    About Volt AI#

    Volt AI is dedicated to making advanced AI technology accessible to developers worldwide. Our mission is to enable rich, conversational experiences that help businesses connect with their customers in meaningful ways.
    Contact Us:
    Website: getvolt.io
    Email: hello@getvolt.io

    Built with ā¤ļø by the Volt AI team
    Ā© 2025 Volt AI. All rights reserved.
    Built with