Model reference · open weights
yoso-normal-5 is an open-weight image model from Stable-X. 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 | Stable-X |
|---|---|
| Type | Image models |
| Task | Image edit |
| Runs with | diffusers |
| Released | 2024-11-07 |
| Popularity | 1k downloads / month |
| Licence | Open weights |
About
This repository contains the weights of StableNormal: Reducing Diffusion Variance for Stable and Sharp Normal
See the Github repository: https://github.com/Stable-X/StableNormal regarding installation instructions.
The model can then be used as follows:
import torch
from PIL import Image
# Load an image
input_image = Image.open("path/to/your/image.jpg")
# Create predictor instance
predictor = torch.hub.load("hugoycj/StableNormal", "StableNormal_turbo", trust_repo=True, yoso_version='yoso-normal-v1-5')
# Generate normal map using alpha channel for masking
normal_map = predictor(rgba_image, data_type="object") # Will mask out background, if alpha channel is avalible, else use birefnet
normal_map = predictor(rgba_image, data_type="outdoor") # Will use Mask2Former to mask out sky and plants
normal_map = predictor(rgba_image, data_type="indoor") # Will not mask out
# Apply the model to the image
normal_image = predictor(input_image)
# Save or display the result
normal_image.save("output/normal_map.png")
From the published model card. Full card on the HuggingFace links in the sidebar.
Using it via the API
Once AxForge deploys yoso-normal-5 for you, it answers on the OpenAI-compatible API — the same base URL and keys as every other model. (yoso-normal-5 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":"yoso-normal-5","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.