StableDiffusionNet.Core

English | Русский

Core library for working with Stable Diffusion WebUI API.

Features

• Minimal dependencies: only Newtonsoft.Json for serialization
• No DI: simple to use without DI infrastructure
• Built-in Retry: custom retry logic implementation
• Asynchronous operations: async/await and CancellationToken support
• XML documentation: for all public APIs
• Builder Pattern: convenient client creation
• Custom logging: minimalistic abstraction without Microsoft.Extensions
• Multi-targeting: supports .NET Standard 2.0, 2.1, .NET 6.0, .NET 8.0

Installation

dotnet add package StableDiffusionNet.Core

Or via NuGet Package Manager:

Install-Package StableDiffusionNet.Core

Quick Start

Simplest Option

using StableDiffusionNet; using StableDiffusionNet.Models.Requests; // Create client with default settings var client = StableDiffusionClientBuilder.CreateDefault("http://localhost:7860"); // Generate image var request = new TextToImageRequest { Prompt = "a beautiful sunset over mountains, highly detailed, 4k", NegativePrompt = "blurry, low quality", Width = 512, Height = 512, Steps = 30 }; var response = await client.TextToImage.GenerateAsync(request);

Using Builder for Configuration

using StableDiffusionNet; using StableDiffusionNet.Logging; // Create client with additional settings var client = new StableDiffusionClientBuilder() .WithBaseUrl("http://localhost:7860") .WithTimeout(600) .WithRetry(retryCount: 3, retryDelayMilliseconds: 1000) .WithApiKey("your-api-key-if-needed") .WithDetailedLogging() .Build();

Using with Custom Logging

// Implement IStableDiffusionLogger public class ConsoleLogger : IStableDiffusionLogger { public void Log(LogLevel logLevel, string message) { Console.WriteLine($"[{logLevel}] {message}"); } public void Log(LogLevel logLevel, Exception exception, string message) { Console.WriteLine($"[{logLevel}] {message}: {exception}"); } public bool IsEnabled(LogLevel logLevel) => true; } // Implement IStableDiffusionLoggerFactory public class ConsoleLoggerFactory : IStableDiffusionLoggerFactory { public IStableDiffusionLogger CreateLogger<T>() => new ConsoleLogger(); public IStableDiffusionLogger CreateLogger(string categoryName) => new ConsoleLogger(); } // Use with Builder var client = new StableDiffusionClientBuilder() .WithBaseUrl("http://localhost:7860") .WithLoggerFactory(new ConsoleLoggerFactory()) .Build();