Clean Architecture .NET 9 Web API — Unified AI Integration (OpenAI, Azure, Gemini, Anthropic, Cohere, HF)

Ship AI features fast with battle-tested architecture.
This production-ready .NET 9 Web API starter kit gives you a clean, scalable foundation and a unified AI integration layer across multiple providers—so you can move from idea to shipped feature in days, not months.

Who is this for?

• .NET developers & teams that want AI features quickly without sacrificing architecture.
• Product builders & startups that need provider-agnostic AI (no vendor lock-in).
• Solution architects standardizing AI across vendors.
• Agencies/contractors delivering reliable AI backends to clients.

Why this instead of building from scratch?

• Multi-provider support out of the box — OpenAI, Azure OpenAI, Google Gemini, Anthropic, Cohere, Hugging Face (HF) via one unified API.
• Clean Architecture foundation — clear Domain / Application / Infrastructure / API layers.
• Production-ready features — CQRS + MediatR, async handlers, Serilog structured logging, HealthChecks, Swagger/OpenAPI.
• Developer experience — paste keys, run, test endpoints immediately.
• Enterprise scalable — designed for teams; proven patterns reduce risk and debt.

Built-in Endpoints

• POST /api/ai/generate-text — provider-agnostic text generation
• POST /api/ai/generate-image — unified image creation
• POST /api/ai/analyze-image — image analysis & description
• GET /api/ai/providers — list & manage configured providers
• GET /api/ai/providers/{provider}/models — model discovery
• GET /api/ai/providers/{provider}/status — provider health
• GET /api/health — overall system health check

Modern Tech Stack

.NET 9, CQRS + MediatR, AutoMapper, Serilog, Swagger/OpenAPI, HealthChecks, Clean Architecture layering, async everywhere.

Security & Ops Readiness (Checklist Included)

• ✅ Key Vault / AWS Secrets Manager integration guide
• ✅ HTTPS enforcement patterns
• ✅ Authentication & Authorization scaffolding
• ✅ Rate limiting implementation
• ✅ Structured logging & monitoring with Serilog
  

What’s Included

• Complete source code with clear, documented architecture
• Unified, multi-provider AI integration (tested & production-ready)
• Interactive Swagger docs for instant testing
• MIT License — commercial use permitted
• Architecture documentation & implementation guides

FAQ ()

Will I be locked to one AI vendor?
No. The provider-agnostic layer lets you switch providers per request or per environment.

Can I add my own provider?
Yes. The abstraction makes it straightforward to register a new provider with minimal boilerplate.

Is this truly production-ready?
You get proven layering, CQRS/MediatR, health checks, logging, rate limiting patterns, and security guidance. Add your cloud infra (TLS termination, WAF, observability) and deploy.

What about costs and quotas?
Use rate limiting and provider switching to control spend and fail over to cheaper models when needed.