MistralSDK.Net 5.0.0

Mistral AI SDK for .NET

A simple and powerful .NET SDK for the Mistral AI API.

Features • Quick Start • Documentation • License

Features

• Chat completion API with full parameter support
• Agents API - Run completions with pre-configured agents
• Models API - List, retrieve, update, archive fine-tuned models
• Embeddings - Text (mistral-embed) and code (codestral-embed) embeddings for RAG
• FIM - Fill-in-the-middle code completion (Codestral)
• Batch API - Asynchronous batch inference for chat, embeddings, FIM, etc.
• Fine-Tuning - Create and manage fine-tuning jobs
• Classifiers - Moderation and classification (text & chat)
• Reasoning - Chain-of-thought with Magistral models (math, coding)
• Audio & Transcription - Transcribe audio to text (Voxtral models)
• OCR / Document AI - Extract text from PDFs and images
• Files API - Upload, list, download files for OCR/fine-tuning/audio
• Streaming responses with IAsyncEnumerable
• All Mistral models (Large, Small, Codestral, Pixtral...)
• JSON mode and JSON Schema support
• Stop sequences, penalties, and sampling controls
• Async/await with cancellation support
• Dependency Injection ready
• Custom exception handling
• Response caching

Installation

dotnet add package MistralSDK.Net

Quick Start

using MistralSDK;
using MistralSDK.ChatCompletion;

var apiKey = Environment.GetEnvironmentVariable("MISTRAL_API_KEY");
using var client = new MistralClient(apiKey);

var request = new ChatCompletionRequest
{
    Model = MistralModels.Small,
    Messages = new List<MessageRequest>
    {
        new MessageRequest { Role = MessageRoles.User, Content = "Hello!" }
    }
};

var response = await client.ChatCompletionAsync(request);
if (response.IsSuccess)
{
    Console.WriteLine(response.Message);
}

OCR (Extract text from documents)

using MistralSDK;

using var stream = File.OpenRead("document.pdf");
var text = await client.OcrExtractTextAsync(stream, "document.pdf");
Console.WriteLine(text);

For document Q&A with conversation history:

using MistralSDK.Workflows;

var qa = new DocumentQa(client);
await qa.LoadDocumentAsync(File.OpenRead("contract.pdf"), "contract.pdf");
Console.WriteLine(await qa.AskAsync("What is the termination clause?"));

Multi-Turn Conversation

using MistralSDK.Conversation;

var session = new ChatSession(client) { SystemPrompt = "You are a helpful assistant." };
session.AddUser("What is the capital of France?");
Console.WriteLine(await session.CompleteAsync());

session.AddUser("And what's the population?");
Console.WriteLine(await session.CompleteAsync());

Streaming

await foreach (var chunk in client.ChatCompletionStreamAsync(request))
{
    Console.Write(chunk.GetContent());
}

Dependency Injection

builder.Services.AddMistralClient(options =>
{
    options.ApiKey = builder.Configuration["MistralApi:ApiKey"];
});

Available Models

Documentation

• Getting Started
• Workflows & Helpers
• OCR & Files
• API Reference

Requirements

• .NET 8.0+
• Mistral AI API key (Get one here)

License

MIT License - see LICENSE for details.