OpenRouter

Features

• AgentFactory (OpenRouterAgentFactory)
• AIToolsFactory integration (tools in AgentOptions.Tools)
• EmbeddingFactory (OpenRouterEmbeddingFactory)
• OpenAI-style reasoning settings and ClientType (ChatClient or ResponsesApi)

Package

dotnet add package AgentFrameworkToolkit.OpenRouter

Quick start

OpenRouterAgentFactory agentFactory = new("<apiKey>");
OpenRouterAgent agent = agentFactory.CreateAgent(new AgentOptions
{
    Model = "openai/gpt-5",
    ReasoningEffort = OpenAIReasoningEffort.Low,
    Instructions = "You are a nice AI"
});

AgentRunResponse response = await agent.RunAsync("Hello World");
Console.WriteLine(response);

Embeddings

OpenRouterEmbeddingFactory embeddingFactory = new("<apiKey>");
IEmbeddingGenerator<string, Embedding<float>> generator = embeddingFactory.GetEmbeddingGenerator("openai/text-embedding-3-small");
Embedding<float> embedding = await generator.GenerateAsync("Hello");

Connection options

• ApiKey (required)
• Endpoint (optional, defaults to https://openrouter.ai/api/v1)
• NetworkTimeout
• DefaultClientType
• AdditionalOpenAIClientOptions

Dependency injection

builder.Services.AddOpenRouterAgentFactory("<apiKey>");
builder.Services.AddOpenRouterAgentFactory(new OpenRouterConnection
{
    ApiKey = "<apiKey>"
});

Notes

• See AgentFactories for shared options and middleware.
• See EmbeddingFactories for more examples.
• See AIToolsFactory for tool creation and MCP support.