In één oogopslag
De Stable Diffusion XL API draait Stable Diffusion XL via Mage op POST https://api.mage.space/v1/stable_diffusion_xl/generate. Een verzoek met de standaardinstellingen kost 10 Gems (ongeveer $0,01), zonder abonnement. Stable Diffusion XL ondersteunt geen @handle-vermeldingen.
Afbeelding
Uitvoer
1
Variant
10
Gems per afbeelding, standaard
$0.01
Ongeveer, in USD
Overzicht
Wat de Stable Diffusion XL API doet
Het klassieke Stable Diffusion XL, afgestemd op fotorealistische resultaten. Tekst-naar-afbeelding of vanuit één invoerafbeelding, tegen een voordelige prijs.
Stable Diffusion XL, afgestemd op fotorealistische resultaten, met een optionele invoerafbeelding.
Accepteert image als invoer.
Snel starten
De Stable Diffusion XL API aanroepen
Stel MAGE_API_KEY in, verstuur je verzoek naar /stable_diffusion_xl/generate en poll status_url tot het verzoek is voltooid.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/stable_diffusion_xl/generate' \
--header "Authorization: Bearer $MAGE_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80"
}' | jq -r '.status_url')
# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"TypeScript
// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';
const mage = new Mage(); // reads MAGE_API_KEY
const request = await mage.run('stable_diffusion_xl', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: '6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("stable_diffusion_xl", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})
print(request["result"]["url"])Modellen
Stable Diffusion XL model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | Stable Diffusion XL | Ja |
Opties
Stable Diffusion XL-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
Invoer
Mediainvoer die Stable Diffusion XL accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| image | De referentieafbeelding. |
Meer beeldmodellen
Andere API's voor beeldgeneratie op Mage
Afbeelding · vanaf 10 Gems
Z-Image API
Het snelste beeldmodel op Mage
Afbeelding · vanaf 20 Gems
Anima API
Speciaal gemaakt voor anime
Afbeelding · vanaf 35 Gems
Chroma API
Open weights, gebouwd op Flux
Afbeelding · vanaf 40 Gems
Flux 2 API
Lange prompts en bewerkingen met meerdere referenties
Afbeelding · vanaf 9 Gems
GPT Image 2 API
Nauwkeurige prompts en leesbare tekst
Afbeelding · vanaf 75 Gems
Grok Image API
Grok Imagine, in drie kwaliteitsniveaus
FAQ
Veelgestelde vragen
Wat kost de Stable Diffusion XL API?
Een Stable Diffusion XL-verzoek met de standaardinstellingen (Stable Diffusion XL) kost 10 Gems, ongeveer $0,01. Andere resoluties, duur en varianten veranderen de prijs; het antwoord toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Stable Diffusion XL API?
POST https://api.mage.space/v1/stable_diffusion_xl/generate met een Authorization: Bearer-header met je Mage API-sleutel. Het antwoord bevat een status_url die je kunt pollen voor het resultaat.
Welke Stable Diffusion XL-modellen kan ik aanroepen?
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. De standaard is Stable Diffusion XL.
Ondersteunt Stable Diffusion XL referentie-afbeeldingen of characters?
Stable Diffusion XL accepteert image. Stable Diffusion XL ondersteunt geen @handle-vermeldingen.
Kan ik Stable Diffusion XL gebruiken vanuit Claude of ChatGPT?
Ja. Verbind de Mage MCP-server met Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam om Stable Diffusion XL. Je assistent leest de opties uit met get_model en noemt de prijs voordat er wordt gegenereerd.
Hoe lang worden Stable Diffusion XL-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.