StableDiffusionNet.Core

Core библиотека для работы с Stable Diffusion WebUI API.

Особенности

• ✨ Минимальные зависимости: только Newtonsoft.Json для сериализации
• 🚀 Без DI: простой в использовании без инфраструктуры DI
• 🔄 Встроенный Retry: надежная и быстрая собственная реализация retry логики
• ⚡ Асинхронные операции: полная поддержка async/await и CancellationToken
• 📝 XML документация: для всех публичных API
• 🎯 Builder Pattern: удобное создание клиента
• 📊 Собственное логирование: минималистичная абстракция без Microsoft.Extensions
• 🎨 Multi-targeting: поддержка .NET Standard 2.0, 2.1, .NET 6.0, .NET 8.0

Установка

dotnet add package StableDiffusionNet.Core

Или через NuGet Package Manager:

Install-Package StableDiffusionNet.Core

Быстрый старт

Простейший вариант

using StableDiffusionNet; using StableDiffusionNet.Models.Requests; // Создание клиента с настройками по умолчанию var client = StableDiffusionClientBuilder.CreateDefault("http://localhost:7860"); // Генерация изображения 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);

Использование Builder для настройки

using StableDiffusionNet; using StableDiffusionNet.Logging; // Создание клиента с дополнительными настройками var client = new StableDiffusionClientBuilder() .WithBaseUrl("http://localhost:7860") .WithTimeout(600) .WithRetry(retryCount: 3, retryDelayMilliseconds: 1000) .WithApiKey("your-api-key-if-needed") .WithDetailedLogging() .Build();

Использование с собственным логированием

// Реализуйте 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; } // Реализуйте IStableDiffusionLoggerFactory public class ConsoleLoggerFactory : IStableDiffusionLoggerFactory { public IStableDiffusionLogger CreateLogger<T>() => new ConsoleLogger(); public IStableDiffusionLogger CreateLogger(string categoryName) => new ConsoleLogger(); } // Используйте с Builder var client = new StableDiffusionClientBuilder() .WithBaseUrl("http://localhost:7860") .WithLoggerFactory(new ConsoleLoggerFactory()) .Build();