We use cookies to enhance your experience and measure how the site performs. Choose "Essential Only" to disable analytics. Read our Privacy Policy.

    Odeus Docs

    API Introduction

    Integrate Odeus's powerful AI capabilities into your applications with our comprehensive API suite

    API Introduction

    Integrate Odeus's powerful AI capabilities into your applications with our comprehensive API suite

    Overview

    The Odeus API provides programmatic access to state-of-the-art AI models while maintaining enterprise-grade security and compliance. Whether you're building custom applications, automating workflows, or enhancing existing systems, our API offers the flexibility and power you need.

    Available APIs

    Completion API

    Access leading language models from OpenAI, Anthropic, Mistral, and Google for text generation, analysis, and reasoning tasks.

    Embedding API

    Generate high-quality embeddings for semantic search, similarity matching, and RAG applications.

    Agent API

    Create and manage custom AI agents programmatically with specialized knowledge and capabilities.

    Knowledge Folder API

    Manage your organization's knowledge base programmatically for RAG and document processing.

    Integrations API

    Create and manage custom integrations with external services programmatically.

    Usage Export API

    Export usage data for analytics, billing, and compliance reporting.

    User Management API

    Programmatically manage workspace users, including automated invitation flows.

    Getting Started

    Base URL

    For standard Odeus Cloud users, use the following base URL for all API requests:
    
    ```
    https://api.odeus.ai
    ```
    
    
    
    If your organization uses a dedicated Odeus deployment (custom domain), your base URL follows this pattern:
    
    ```
    https://<your-domain>/api/public
    ```
    
    For example, if your Odeus instance is at `https://odeus.yourcompany.com`, the API base URL would be:
    
    ```
    https://odeus.yourcompany.com/api/public
    ```
    
    > **Common mistake:** Don't forget the `/api/public` prefix when using a dedicated deployment. Using just your domain without this prefix will result in authentication errors or redirects.
    

    Authentication

    All API requests require authentication using a Bearer token:

    curl -H "Authorization: Bearer YOUR_API_KEY" \
      https://api.odeus.ai/openai/eu/v1/chat/completions
    

    Security Note:

    Odeus intentionally blocks browser-origin requests to protect your API key and ensure your applications remain secure. Calling the API from the browser (e.g., from JavaScript running in a web page) exposes the Odeus API Key publicly and creates a security risk. Therefore, the Odeus API must be accessed from a secure backend environment. For more information, please see our guide on API Key Best Practices.

    Rate Limits

    API requests are subject to rate limiting to ensure fair usage and system stability. Rate limits are applied per model. The default limits are 500 RPM (requests per minute) and 60,000 TPM (tokens per minute). If you consistently hit these limits, reach out to our support team to discuss an increase in rate limits.

    For BYOK workspaces, admins can configure custom limits per model in Settings > Models.

    Key Features

    • GDPR Compliant — All API operations maintain full GDPR compliance with data processing in EU regions

    • Multiple Models — Access models from OpenAI, Anthropic, Mistral, and more through a unified interface

    • Enterprise Security — SOC 2 certified infrastructure with end-to-end encryption and audit logging

    • BYOK Support — Bring Your Own Key (BYOK) option for enhanced control over API access

    Use Cases

    • Custom Applications: Build AI-powered features into your applications
    • Workflow Automation: Automate document processing and analysis
    • Data Analysis: Extract insights from large volumes of text data
    • Content Generation: Create high-quality content at scale
    • Semantic Search: Implement intelligent search across your knowledge base

    Support

    For API support and questions reach out to us at [email protected].