Treci la conținut

Mage API · Model de imagine

API Stable Diffusion XL

SDXL optimizat pentru fotorealism

POST https://api.mage.space/v1/stable_diffusion_xl/generate

Pe scurt

API-ul Stable Diffusion XL rulează Stable Diffusion XL prin Mage la POST https://api.mage.space/v1/stable_diffusion_xl/generate. O cerere cu setările implicite costă 10 Gems (aproximativ 0,01 $), fără abonament. Stable Diffusion XL nu acceptă mențiuni @handle.

  • ImagineRezultat
  • 1Variantă
  • 10Gems per imagine, implicit
  • $0.01Aproximativ, în USD

Prezentare generală

Ce face API-ul Stable Diffusion XL

Stable Diffusion XL clasic, optimizat pentru rezultate fotorealiste. Din text în imagine sau pornind de la o imagine de intrare, la un preț accesibil.

Stable Diffusion XL, optimizat pentru rezultate fotorealiste, cu imagine de intrare opțională.

Acceptă image ca intrare.

Pornire rapidă

Apelează API-ul Stable Diffusion XL

Setează MAGE_API_KEY, trimite cererea la /stable_diffusion_xl/generate și interoghează status_url până când cererea se finalizează.

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"])

Modele

Valori model_id pentru Stable Diffusion XL

Trimite model_id pentru a alege o variantă. O cerere fără el rulează varianta implicită.

model_idNumeImplicit
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLDa

Opțiuni

Parametrii Stable Diffusion XL

Valori permise pentru toate variantele; o variantă poate oferi mai puține. Documentația listează opțiunile pentru fiecare variantă.

CâmpValori
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Intrări

Intrări media acceptate de Stable Diffusion XL

Trimite fiecare intrare ca URL https, ca data URL sau ca încărcare de până la 100 MB.

CâmpRol
imageImaginea de referință.

Mai multe modele de imagini

Alte API-uri de generare de imagini pe Mage

  • Imagine · de la 10 Gems

    API Z-Image

    Cel mai rapid model de imagini de pe Mage

  • Imagine · de la 20 Gems

    Anima API

    Creat special pentru anime

  • Imagine · de la 35 Gems

    API Chroma

    Open-weights, construit pe Flux

  • Imagine · de la 40 de Gems

    API Flux 2

    Prompturi lungi și editări cu mai multe referințe

  • Imagine · de la 9 Gems

    API GPT Image 2

    Prompturi precise și text lizibil

  • Imagine · de la 75 Gems

    API Grok Image

    Grok Imagine, în trei niveluri de calitate

Întrebări frecvente

Întrebări frecvente

Cât costă API-ul Stable Diffusion XL?
O cerere Stable Diffusion XL cu setările implicite (Stable Diffusion XL) costă 10 Gems, aproximativ 0,01 $. Alte rezoluții, durate și variante modifică prețul; răspunsul indică costul exact. O generare eșuată este rambursată; una blocată de politica de conținut Mage nu este.
Care este endpoint-ul API-ului Stable Diffusion XL?
POST https://api.mage.space/v1/stable_diffusion_xl/generate cu un header Authorization: Bearer care conține cheia ta API Mage. Răspunsul include un status_url pe care îl interoghezi periodic pentru rezultat.
Ce modele Stable Diffusion XL pot apela?
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. Modelul implicit este Stable Diffusion XL.
Stable Diffusion XL acceptă imagini de referință sau personaje?
Stable Diffusion XL acceptă image. Stable Diffusion XL nu acceptă mențiuni @handle.
Pot folosi Stable Diffusion XL din Claude sau ChatGPT?
Da. Conectează serverul Mage MCP la Claude, ChatGPT, Claude Code, Grok sau Cursor și cere Stable Diffusion XL pe nume. Asistentul tău citește opțiunile cu get_model și îți spune prețul înainte de a genera.
Cât timp sunt păstrate rezultatele Stable Diffusion XL?
Rezultatele și datele de intrare se păstrează 30 de zile. Descarcă tot ce vrei să păstrezi în propriul spațiu de stocare.

Începe să construiești cu Mage

Un singur cont, un singur sold de Gems, toate modelele. Plătești doar pentru ce generezi.