Skip to content
New site — Virtual Media Folders now has its own home.Visit vmf.soderlind.no →

AI Router Documentation

AI Router provides capability-based routing for WordPress 7.0 AI requests — automatically directing each request to the most appropriate provider configuration.

WordPress 7.0 introduced the AI Client SDK, but different providers excel at different tasks:

  • OpenAI GPT-4 — text generation and chat
  • DALL-E / Stable Diffusion — image generation
  • Anthropic Claude — reasoning and analysis
  • Local Ollama models — privacy and cost benefits

AI Router lets you configure multiple providers and route each capability to the best one.

Document Description
Routing How routing decisions are made (priority, fallbacks)
Data Model Configuration, RequestContext, and Vocabulary DTOs
Provider Discovery How AI providers are discovered and configured
WordPress Integration Hooks, REST API, credential sync
Extensibility Filters, actions, security considerations
sequenceDiagram
    participant App as Plugin/Theme
    participant Router as AI Router
    participant Map as CapabilityMap
    participant Repo as ConfigRepository
    participant Provider as AI Provider

    App->>Router: AI Request (e.g., text_generation)
    Router->>Map: Check explicit mapping
    alt Mapping exists
        Map-->>Router: Mapped config ID
        Router->>Repo: Get config
        Repo-->>Router: Configuration
    else No mapping
        Router->>Repo: Get default config
        alt Default supports capability
            Repo-->>Router: Default configuration
        else Default doesn't support
            Router->>Repo: Find any supporting config
            Repo-->>Router: Fallback (sorted by priority)
        end
    end
    Router->>Provider: Route request
    Note over Provider: OpenAI, Anthropic,<br/>Azure OpenAI, Ollama
Layer Components
Admin UI ConnectorsIntegration.php, connectors.js
REST API ConfigurationsController.php
Domain ConfigurationService.php, Vocabulary.php
Core Logic Router.php, CapabilityMap.php, ConnectorSync.php, ProviderDiscovery.php
Data ConfigurationRepository.php, Configuration.php, RequestContext.php
Storage wp_options
ai-router/
├── src/
│ ├── DTO/
│ │ ├── Configuration.php # Immutable config data object
│ │ └── RequestContext.php # Per-request routing state
│ ├── Repository/
│ │ └── ConfigurationRepository.php
│ ├── Service/
│ │ └── ConfigurationService.php # Domain logic
│ ├── Admin/
│ │ └── ConnectorsIntegration.php
│ ├── Rest/
│ │ └── ConfigurationsController.php
│ ├── Vocabulary.php
│ ├── CapabilityMap.php
│ ├── ConnectorSync.php
│ ├── Router.php
│ └── ProviderDiscovery.php
├── src/js/
│ └── connectors.js
└── tests/
├── php/ # PHPUnit (126 tests)
└── js/ # Vitest (6 tests)
Capability Description
text_generation Generate text responses (GPT, Claude, etc.)
chat_history Maintain conversation context
image_generation Generate images (DALL-E, Stable Diffusion)
embedding_generation Create vector embeddings
text_to_speech_conversion Convert text to audio
speech_generation Generate speech/audio
music_generation Generate music
video_generation Generate video content