Mage API · Model obrazu

API Stable Diffusion XL

SDXL dostrojony do fotorealizmu

Zdobądź klucz APIWypróbuj Stable Diffusion XL w playground
POST https://api.mage.space/v1/stable_diffusion_xl/generate

W skrócie

API Stable Diffusion XL uruchamia Stable Diffusion XL przez Mage pod adresem POST https://api.mage.space/v1/stable_diffusion_xl/generate. Żądanie z ustawieniami domyślnymi kosztuje 10 Gems (około 0,01 $), bez subskrypcji. Stable Diffusion XL nie obsługuje wzmianek @handle.

Przegląd

Co robi API Stable Diffusion XL

Klasyczne Stable Diffusion XL, dostrojone do fotorealistycznych wyników. Tekst na obraz lub na podstawie jednego obrazu wejściowego, w niskiej cenie.

Stable Diffusion XL, dostrojone do fotorealistycznych wyników, z opcjonalnym obrazem wejściowym.

Jako dane wejściowe przyjmuje image.

Szybki start

Wywołaj API Stable Diffusion XL

Ustaw MAGE_API_KEY, wyślij żądanie na /stable_diffusion_xl/generate i odpytuj status_url, aż żądanie zostanie zrealizowane.

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

Wartości model_id dla Stable Diffusion XL

Wyślij model_id, aby wybrać wariant. Zapytanie bez niego użyje wariantu domyślnego.

model_idNazwaDomyślny
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLTak

Opcje

Parametry Stable Diffusion XL

Dozwolone wartości dla wszystkich wariantów; dany wariant może oferować mniej. Opcje dla poszczególnych wariantów znajdziesz w dokumentacji.

PoleWartości
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Dane wejściowe

Dane wejściowe multimedialne obsługiwane przez Stable Diffusion XL

Każdy wyślij jako URL https, data URL lub plik o rozmiarze do 100 MB.

PoleRola
imageObraz referencyjny.

Więcej modeli obrazów

Inne API do generowania obrazów w Mage

Obraz · od 10 Gems

Z-Image API

Najszybszy model obrazów w Mage

Obraz · od 20 Gems

Anima API

Stworzone z myślą o anime

Obraz · od 35 Gems

Chroma API

Otwarte wagi, oparty na Flux

Obraz · od 40 Gems

Flux 2 API

Długie prompty i edycje z wieloma referencjami

Obraz · od 9 Gems

GPT Image 2 API

Precyzyjne prompty i czytelny tekst

Obraz · od 75 Gems

Grok Image API

Grok Imagine w trzech poziomach jakości

FAQ

Najczęściej zadawane pytania

Ile kosztuje API Stable Diffusion XL?

Zapytanie do Stable Diffusion XL z ustawieniami domyślnymi (Stable Diffusion XL) kosztuje 10 Gems, czyli około $0.01. Inne rozdzielczości, czasy trwania i warianty zmieniają cenę, a dokładną kwotę zobaczysz w odpowiedzi. Za nieudaną generację zwracamy Gems, ale nie za tę, którą zablokowały zasady treści Mage.

Jaki jest endpoint API Stable Diffusion XL?

POST https://api.mage.space/v1/stable_diffusion_xl/generate z nagłówkiem Authorization: Bearer zawierającym Twój klucz API Mage. Odpowiedź zawiera status_url, który odpytujesz, żeby odebrać wynik.

Które modele Stable Diffusion XL mogę wywołać?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. Domyślny to Stable Diffusion XL.

Czy Stable Diffusion XL obsługuje obrazy referencyjne lub postacie?

Stable Diffusion XL przyjmuje image. Stable Diffusion XL nie obsługuje wzmianek @handle.

Czy mogę używać Stable Diffusion XL w Claude lub ChatGPT?

Tak. Połącz serwer Mage MCP z Claude, ChatGPT, Claude Code, Grok lub Cursorem i poproś o Stable Diffusion XL po nazwie. Asystent odczyta opcje modelu przez get_model i poda cenę, zanim cokolwiek wygeneruje.

Jak długo przechowywane są wyniki Stable Diffusion XL?

Wyniki i dane wejściowe są przechowywane przez 30 dni. Wszystko, co chcesz zachować, pobierz na własny dysk.

Zacznij tworzyć z Mage

Jedno konto, jedno saldo Gems, wszystkie modele. Płacisz tylko za to, co wygenerujesz.

Zdobądź klucz APIWypróbuj Stable Diffusion XL w playground

Powiązane