An unofficial Rust API client for [Stability-AI](https://stability.ai/) text-to-speech software.

## ⚙️ Requirements

- Set API key to environment variable `STABILITY_API_KEY`

## 🗣️ Usage

### Text to Image

 ```rust
 use stability_rs::{text_to_img::*, Result, ClipGuidancePreset, Sampler, StylePreset};

    #[tokio::main]
    async fn main() -> Result<()> {
        let image = TextToImageBuilder::new()
            .height(1024)?
            .width(1024)?
            .cfg_scale(27)?
            .clip_guidance_preset(ClipGuidancePreset::FastBlue)?
            .sampler(Sampler::KDpmpp2sAncestral)?
            .samples(2)?
            .seed(0)?
            .steps(33)?
            .style_preset(StylePreset::DigitalArt)?
            .text_prompt("A scholar tired at his desk, a raven on a bust", 1.0)?
            .build()?;

        let resp = image.generate("stable-diffusion-xl-1024-v1-0").await?;

        for (i, image) in resp.artifacts.iter().enumerate() {
            let _ = image.save(&format!("image_{}.png", i)).await?;
        }

        Ok(())
    }
  ```
### Image to Image

```rust
use stability_rs::{img_to_img::*, Result, ClipGuidancePreset, Sampler, StylePreset,};

   #[tokio::main]
   async fn main() -> Result<()> {
        let image = ImageToImageBuilder::new()
           .init_image_path("init_image.png")?
           .init_image_mode(ImageMode::ImageStrength)?
           .image_strength(0.35)?
           .cfg_scale(7)?
           .clip_guidance_preset(ClipGuidancePreset::FastBlue)?
           .sampler(Sampler::KDpm2Ancestral)?
           .samples(3)?
           .seed(0)?
           .steps(20)?
           .style_preset(StylePreset::FantasyArt)?
           .text_prompt("A crab relaxing on a beach", 0.5)?
           .text_prompt("stones", -0.9)?
           .build()?;
        
        let resp = image.generate("stable-diffusion-xl-1024-v1-0").await?;
        
        for (i, img) in resp.artifacts.iter().enumerate() {
            let _ = img.save(&format!("new_image_{}.png", i)).await?;
        }
        
        Ok(())
}
```

### Image Upscaling

```rust
use stability_rs::{upscale::*, Result,};
    
     #[tokio::main]
     async fn main() -> Result<()> {
        let image = UpscalerBuilder::new()
           .image("1024_image.png")?
           .height(2048)?
           .build()?;
    
        let resp = image.generate(UpscaleEngine::EsrganV1X2Plus).await?;
    
        resp.artifacts.first().unwrap().save("2048_image.png").await?;
    
       Ok(())
     }
```

### Image Masking

```rust
use stability_rs::{masking::*, Result, StylePreset, ClipGuidancePreset};
    
     #[tokio::main]
     async fn main() -> Result<()> {
        let engine = "stable-inpainting-512-v2-0";
    
        let image = MaskerBuilder::new()
          .init_image_path("init_image.png")?
          .mask_source(MaskSource::MaskImageBlack)?
          .mask_image("black_mask_image.png")?
          .text_prompt("a crab dancing", 1.0)?
          .style_preset(StylePreset::FantasyArt)?
          .clip_guidance_preset(ClipGuidancePreset::FastBlue)?
          .build()?;
    
        let resp = image.generate(engine).await?;
    
        resp.artifacts.first().unwrap().save("masked_image.png").await?;
    
        Ok(())
     }
```