Model reference · open weights
shuttle-3.1-aesthetic is an open-weight image model from shuttleai. AxForge deploys and operates it for you on dedicated EU-owned hardware — with the licence handled where one is required.
Available as managed deployment — configured and operated for you on dedicated EU hardware, quoted per deployment.
What it is
| Released by | shuttleai |
|---|---|
| Type | Image models |
| Task | Text→image |
| Parameters (lead) | 11.9B |
| Runs with | diffusers |
| Based on | shuttleai/shuttle-3-diffusion |
| Released | 2024-11-29 |
| Popularity | 1k downloads / month |
| Licence | Open weights |
About
These model variants provide different precision levels and formats optimized for diverse hardware capabilities and use cases
Shuttle 3.1 Aesthetic is a text-to-image AI model designed to create detailed and aesthetic images from textual prompts in just 4 to 6 steps. It offers enhanced performance in image quality, typography, understanding complex prompts, and resource efficiency.
You can try out the model through a website at https://designer.shuttleai.com/
You can use Shuttle 3.1 Aesthetic via API through ShuttleAI
Install or upgrade diffusers
pip install -U diffusers
Then you can use DiffusionPipeline to run the model
import torch
from diffusers import DiffusionPipeline
# Load the diffusion pipeline from a pretrained model, using bfloat16 for tensor types.
pipe = DiffusionPipeline.from_pretrained(
"shuttleai/shuttle-3.1-aesthetic", torch_dtype=torch.bfloat16
).to("cuda")
# Uncomment the following line to save VRAM by offloading the model to CPU if needed.
# pipe.enable_model_cpu_offload()
# Uncomment the lines below to enable torch.compile for potential performance boosts on compatible GPUs.
# Note that this can increase loading times considerably.
# pipe.transformer.to(memory_format=torch.channels_last)
# pipe.transformer = torch.compile(
# pipe.transformer, mode="max-autotune", fullgraph=True
# )
# Set your prompt for image generation.
prompt = "A cat holding a sign that says hello world"
# Generate the image using the diffusion pipeline.
image = pipe(
prompt,
height=1024,
width=1024,
guidance_scale=3.5,
num_inference_steps=4,
max_sequence_length=256,
# Uncomment the line below to use a manual seed for reproducible results.
# generator=torch.Generator("cpu").manual_seed(0)
).images[0]
# Save the generated image.
image.save("shuttle.png")
To learn more check out the diffusers documentation
To run local inference with Shuttle 3.1 Aesthetic using ComfyUI, you can use this safetensors file.
Shuttle 3.1 Aesthetic uses Shuttle 3 Diffusion as its base. It can produce images similar to Flux Dev in just 4 steps, and it is licensed under Apache 2. The model was partially de-distilled during training. We overcame the limitations of the Schnell-series models by employing a special training method, resulting in improved details and colors.
From the published model card. Full card on the HuggingFace links in the sidebar.
How it works
Using it via the API
Once AxForge deploys shuttle-3-1-aesthetic for you, it answers on the OpenAI-compatible API — the same base URL and keys as every other model. (shuttle-3-1-aesthetic below is illustrative; you get the exact model name on deployment.)
$ curl -sS https://api.axforge.ai/v1/images/generations \
-H "Authorization: Bearer $AXFORGE_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"shuttle-3-1-aesthetic","prompt":"a red bicycle","size":"1024x1024"}'
Create an account — your API key is available in the console. 3M free tokens every 30 days with every new account.