MicrosoftFoundry 1.0.0

<div class="docs-hero"> <h1>MicrosoftFoundry</h1> <p class="docs-hero-lead">Modern .NET SDK for MicrosoftFoundry generated from the provider's OpenAPI definition with AutoSDK.</p> <div class="docs-badge-row"> <a href="https://www.nuget.org/packages/MicrosoftFoundry/"><img alt="Nuget package" src="https://img.shields.io/nuget/vpre/MicrosoftFoundry"></a> <a href="https://github.com/tryAGI/MicrosoftFoundry/actions/workflows/dotnet.yml"><img alt="dotnet" src="https://github.com/tryAGI/MicrosoftFoundry/actions/workflows/dotnet.yml/badge.svg?branch=main"></a> <a href="https://github.com/tryAGI/MicrosoftFoundry/blob/main/LICENSE"><img alt="License: MIT" src="https://img.shields.io/github/license/tryAGI/MicrosoftFoundry"></a> <a href="https://discord.gg/Ca2xhfBf3v"><img alt="Discord" src="https://img.shields.io/discord/1115206893015662663?label=Discord&logo=discord&logoColor=white&color=d82679"></a> </div> <div class="docs-hero-actions"> <a href="#usage">Get started</a> <a href="#support">Get support</a> </div> </div>

<div class="docs-feature-grid"> <div class="docs-feature-card"> <h3>Generated from the source spec</h3> <p>Built from <a href="src/libs/MicrosoftFoundry/openapi.yaml">Microsoft Foundry's OpenAPI definition</a> so the SDK stays close to the upstream API surface.</p> </div> <div class="docs-feature-card"> <h3>Auto-updated</h3> <p>Designed for fast regeneration and low-friction updates when the upstream API changes without breaking compatibility.</p> </div> <div class="docs-feature-card"> <h3>Modern .NET</h3> <p>Targets current .NET practices including nullability, trimming, NativeAOT awareness, and source-generated serialization.</p> </div> <div class="docs-feature-card"> <h3>Docs from examples</h3> <p>Examples stay in sync between the README, MkDocs site, and integration tests through the AutoSDK docs pipeline.</p> </div> </div>

Usage

using MicrosoftFoundry;

using var client = new MicrosoftFoundryClient(apiKey);

Generate image

Generate an image with a deployed Microsoft Foundry MAI image model.

var apiKey =
    Environment.GetEnvironmentVariable("MICROSOFT_FOUNDRY_API_KEY") is { Length: > 0 } apiKeyValue
        ? apiKeyValue
        : throw new AssertInconclusiveException("MICROSOFT_FOUNDRY_API_KEY environment variable is not found.");

var endpoint =
    Environment.GetEnvironmentVariable("MICROSOFT_FOUNDRY_ENDPOINT") is { Length: > 0 } endpointValue
        ? new Uri(endpointValue)
        : throw new AssertInconclusiveException("MICROSOFT_FOUNDRY_ENDPOINT environment variable is not found.");

using var client = new MicrosoftFoundryClient(apiKey, baseUri: endpoint);

var deploymentName =
    Environment.GetEnvironmentVariable("MICROSOFT_FOUNDRY_IMAGE_DEPLOYMENT") is { Length: > 0 } deploymentValue
        ? deploymentValue
        : "mai-image-2";

var response = await client.GenerateImageAsync(
    model: deploymentName,
    prompt: "A photorealistic image of a mountain lake at sunrise.",
    width: 1024,
    height: 1024);

Support

<div class="docs-card-grid"> <div class="docs-card"> <h3>Bugs</h3> <p>Open an issue in <a href="https://github.com/tryAGI/MicrosoftFoundry/issues">tryAGI/MicrosoftFoundry</a>.</p> </div> <div class="docs-card"> <h3>Ideas and questions</h3> <p>Use <a href="https://github.com/tryAGI/MicrosoftFoundry/discussions">GitHub Discussions</a> for design questions and usage help.</p> </div> <div class="docs-card"> <h3>Community</h3> <p>Join the <a href="https://discord.gg/Ca2xhfBf3v">tryAGI Discord</a> for broader discussion across SDKs.</p> </div> </div>

Acknowledgments

This project is supported by JetBrains through the Open Source Support Program.