AI Providers Overview

Reveal SDK AI uses a provider-based architecture that lets you integrate with different large language model (LLM) services. The same set of providers is available on ASP.NET Core, Node.js, and Java — only the registration syntax differs.

Available Providers

Provider	ASP.NET NuGet	Node.js / Java key	Extension Method (ASP.NET)
OpenAI	Reveal.Sdk.AI.OpenAI	openai	.AddOpenAI()
Azure OpenAI	Reveal.Sdk.AI.AzureOpenAI	azure-openai	.AddAzureOpenAI()
Anthropic	Reveal.Sdk.AI.Anthropic	anthropic	.AddAnthropic()
Google Gemini	Reveal.Sdk.AI.Google	google	.AddGoogle()

For ASP.NET Core, each provider is a separate NuGet package — install only the ones you need. For Node.js (reveal-sdk-node-ai) and Java (reveal-sdk-ai), the provider implementations are bundled in the main AI package.

How Providers Work

All providers implement a common provider interface and are registered with the AI runtime. The SDK supports registering multiple providers simultaneously and resolves the appropriate one based on the request or a configured default.

Registering Providers

ASP.NET

Chain extension methods after AddRevealAI():

builder.Services.AddRevealAI()
    .AddOpenAI(options =>
    {
        options.ApiKey = "your-api-key";
    })
    .AddAnthropic(options =>
    {
        options.ApiKey = "your-api-key";
    });

Node.js

Pass each provider's settings under its lowercase key in the settings object:

revealAI.withOptions({
    defaultProvider: 'openai',
    settings: {
        openai:    { ApiKey: 'your-api-key' },
        anthropic: { ApiKey: 'your-api-key' }
    }
});

Java

Pass each provider's settings under its lowercase key in the settings map:

Map<String, Object> aiSettings = Map.of(
        "openai",    Map.of("ApiKey", "your-api-key"),
        "anthropic", Map.of("ApiKey", "your-api-key"));

RevealAIPluginOptions aiPluginOptions = new RevealAIPluginOptions(
        "openai",
        "config/catalog.json",
        null,
        null,
        Map.of("settings", aiSettings));

Default Provider

The SDK uses a default provider when no specific provider is requested. Available provider keys: openai, azure-openai, anthropic, google.

ASP.NET

appsettings.json

{
  "RevealAI": {
    "DefaultProvider": "openai"
  }
}

Node.js

revealAI.withOptions({
    defaultProvider: 'openai',
    settings: { /* ... */ }
});

Java

The default provider is the first argument to the RevealAIPluginOptions constructor:

new RevealAIPluginOptions(
        "openai",   // defaultProvider
        /* catalog file */ "config/catalog.json",
        null, null,
        Map.of("settings", aiSettings));

Configuration Binding

For ASP.NET Core, all providers support configuration binding from appsettings.json under the RevealAI section. Options set in code take precedence over configuration file values:

appsettings.json

{
  "RevealAI": {
    "DefaultProvider": "openai",
    "OpenAI": {
      "ApiKey": "sk-...",
      "Model": "gpt-4.1"
    },
    "Anthropic": {
      "ApiKey": "sk-ant-..."
    }
  }
}

For Node.js and Java, load your settings from environment variables, a secrets manager, or a local config file and pass them inline at startup.

Multiple Providers

You can register multiple providers and the SDK will resolve the appropriate one based on the request. This is useful for scenarios such as:

• Using different models for different types of analysis
• Providing fallback options
• Cost optimization by routing simpler tasks to less expensive models

ASP.NET

builder.Services.AddRevealAI()
    .AddOpenAI()        // Registered as "openai"
    .AddAnthropic()     // Registered as "anthropic"
    .AddGoogle();       // Registered as "google"

Node.js

revealAI.withOptions({
    defaultProvider: 'openai',
    settings: {
        openai:    { ApiKey: process.env.OPENAI_API_KEY },
        anthropic: { ApiKey: process.env.ANTHROPIC_API_KEY },
        google:    { ProjectId: process.env.GCP_PROJECT_ID }
    }
});

Java

Map<String, Object> aiSettings = Map.of(
        "openai",    Map.of("ApiKey", System.getenv("OPENAI_API_KEY")),
        "anthropic", Map.of("ApiKey", System.getenv("ANTHROPIC_API_KEY")),
        "google",    Map.of("ProjectId", System.getenv("GCP_PROJECT_ID")));

Custom Providers

If you need to integrate with an LLM service that isn't supported out of the box, you can build a custom provider. Custom providers are currently supported on ASP.NET Core only.