Table of Contents

Create a Job

Submit image generation jobs via sdkClient.Jobs.CreateImage().

Basic Generation

var result = await sdkClient.Jobs
    .CreateImage()
    .WithAir(new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072))
    .WithPositivePrompt("a beautiful sunset over mountains")
    .WithNegativePrompt("blurry, low quality")
    .WithScheduler(Scheduler.EulerAncestral)
    .WithDimensions(1024, 1024)
    .WithSteps(30)
    .WithConfigurationScale(7.5m)
    .ExecuteAsync();

if (result is Result<JobStatusCollection>.Success success)
{
    Console.WriteLine($"Job submitted with token: {success.Data.Token}");
    foreach (var job in success.Data.JobsList)
    {
        Console.WriteLine($"Job ID: {job.JobId}, Cost: {job.Cost}");
    }
}

Advanced Configuration

var advancedModel = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072);

var advancedResult = await sdkClient.Jobs
    .CreateImage()
    .WithAir(advancedModel)
    .WithPositivePrompt("detailed portrait")
    .WithScheduler(Scheduler.DpmPlusPlus2MSdeKarras)
    .WithSeed(12345)
    .WithSteps(50)
    .WithConfigurationScale(8.5m)
    .WithQuantity(4)  // Generate 4 images
    .WithClipSkip(2)
    .WithCallbackUrl("https://example.tld/webhook")
    .WithRetries(3)
    .ExecuteAsync();

Additional Networks (LoRAs)

var baseModel = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072);
var lora = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Lora, AirSource.Civitai, 123456, 789);
var anotherLora = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Lora, AirSource.Civitai, 234567, 890);

var loraResult = await sdkClient.Jobs
    .CreateImage()
    .WithAir(baseModel)
    .WithPositivePrompt("character portrait")
    .WithAdditionalNetwork(lora, NetworkBuilder.Create()
        .WithStrength(0.8m)
        .WithTriggerWord("character")
        .Build())
    .WithAdditionalNetwork(anotherLora, NetworkBuilder.Create()
        .WithStrength(0.5m)
        .Build())
    .ExecuteAsync();

ControlNet

var controlNetModel = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072);

var controlNetResult = await sdkClient.Jobs
    .CreateImage()
    .WithAir(controlNetModel)
    .WithPositivePrompt("person standing")
    .WithControlNet(ControlNetBuilder.Create()
        .WithImageUrl("https://example.tld/pose.png")
        .WithPreprocessor(ControlNetPreprocessor.Canny)
        .WithWeight(1.0m)
        .WithStartStep(0.0m)
        .WithEndStep(1.0m)
        .Build())
    .ExecuteAsync();

Batch Submission

var firstCheckpoint = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072);
var secondCheckpoint = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 101055, 128078);

var landscapeJob = sdkClient.Jobs
    .CreateImage()
    .WithAir(firstCheckpoint)
    .WithPositivePrompt("landscape");

var portraitJob = sdkClient.Jobs
    .CreateImage()
    .WithAir(secondCheckpoint)
    .WithPositivePrompt("portrait");

var batchResult = await landscapeJob.ExecuteBatchAsync([portraitJob]);

if (batchResult is Result<JobStatusCollection>.Success batchSuccess)
{
    Console.WriteLine($"Batch submitted with token: {batchSuccess.Data.Token}");
}

Complete Example

var baseCheckpoint = new AirIdentifier(AirEcosystem.StableDiffusionXl, AirAssetType.Checkpoint, AirSource.Civitai, 4201, 130072);

var fullParameterJob = await sdkClient.Jobs
    .CreateImage()
    .WithAir(baseCheckpoint)
    .WithPositivePrompt("masterpiece, best quality, professional photograph, cyberpunk street scene, neon lights, rain, reflections, highly detailed, 8k uhd")
    .WithNegativePrompt("blurry, low quality, bad anatomy, deformed, watermark, signature, text, jpeg artifacts, worst quality, low resolution")
    .WithScheduler(Scheduler.DpmPlusPlus2MSdeKarras)
    .WithDimensions(1024, 1536) // Portrait orientation
    .WithSteps(40) // Higher steps for quality
    .WithConfigurationScale(8.5m) // Strong prompt adherence
    .WithSeed(987654321) // Reproducible results
    .WithClipSkip(2) // Better artistic interpretation
    .WithQuantity(4) // Generate 4 variations
    .WithPriority(Priority.Default)
    .WithCallbackUrl("https://example.tld/webhook/generation-complete") // Async notification
    .WithRetries(3) // Retry failed jobs
    .WithTimeout(TimeSpan.FromMinutes(15)) // 15-minute timeout
    .ExecuteAsync();

if (fullParameterJob is Result<JobStatusCollection>.Success jobSuccess)
{
    Console.WriteLine($"Submitted {jobSuccess.Data.JobsList.Count} jobs");
    Console.WriteLine($"Batch token: {jobSuccess.Data.Token}");
}

Next Steps

Edit this page