Přeskočit na obsah

Mage API · Model pro obrázky

SDXL Plus API

SDXL s opravenými obličeji a rukama

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

Stručně

SDXL Plus API spouští SDXL Plus přes Mage na POST https://api.mage.space/v1/sdxl_plus/generate. Požadavek s výchozím nastavením stojí 15 Gems (asi 0,015 $), bez předplatného. SDXL Plus nepodporuje zmínky přes @handle.

  • ObrázekVýstup
  • 1Varianta
  • 15Gems za obrázek, výchozí
  • $0.015Přibližně v USD

Přehled

K čemu slouží SDXL Plus API

Náš vysoce detailní SDXL pipeline s automatickou úpravou obličejů a rukou. Z textu na obrázek nebo z jednoho vstupního obrázku; pomalejší než obyčejné SDXL, ale stojí to za to.

Vysoce detailní SDXL pipeline od Mage s automatickou úpravou obličejů a rukou a volitelným vstupním obrázkem.

Jako vstup přijímá image.

Rychlý start

Volání SDXL Plus API

Nastav MAGE_API_KEY, odešli požadavek na /sdxl_plus/generate a opakovaně kontroluj status_url, dokud se požadavek nedokončí.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/sdxl_plus/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('sdxl_plus', {
  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("sdxl_plus", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80",
})

print(request["result"]["url"])

Modely

Hodnoty model_id pro SDXL Plus

Variantu vybereš pomocí model_id. Požadavek bez něj použije výchozí.

model_idNázevVýchozí
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80SDXL PlusAno

Možnosti

Parametry SDXL Plus

Povolené hodnoty napříč všemi variantami; konkrétní varianta jich může nabízet méně. Možnosti pro jednotlivé varianty najdeš v dokumentaci.

PoleHodnoty
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Vstupy

Vstupní média, která SDXL Plus přijímá

Každý pošli jako https URL, data URL nebo nahraj soubor o velikosti do 100 MB.

PoleRole
imageReferenční obrázek.

Další modely pro obrázky

Další API pro generování obrázků na Mage

Časté dotazy

Často kladené otázky

Kolik stojí SDXL Plus API?
Požadavek na SDXL Plus s výchozím nastavením (SDXL Plus) stojí 15 Gems, tedy asi 0,015 $. Jiná rozlišení, délky a varianty cenu mění; přesnou částku najdeš v odpovědi. Gems za neúspěšné generování se vrací, za generování zablokované zásadami obsahu Mage ne.
Jaký je endpoint SDXL Plus API?
POST https://api.mage.space/v1/sdxl_plus/generate s hlavičkou Authorization: Bearer, která obsahuje tvůj API klíč Mage. Odpověď obsahuje status_url, na kterém si výsledek vyzvedneš.
Které modely SDXL Plus můžu volat?
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. Výchozí je SDXL Plus.
Podporuje SDXL Plus referenční obrázky nebo postavy?
SDXL Plus přijímá image. SDXL Plus nepodporuje zmínky přes @handle.
Můžu SDXL Plus používat z Claude nebo ChatGPT?
Ano. Připoj server Mage MCP ke Claude, ChatGPT, Claude Code, Grok nebo Cursoru a požádej o SDXL Plus jménem. Asistent si přes get_model přečte jeho možnosti a před generováním oznámí cenu.
Jak dlouho se výsledky SDXL Plus uchovávají?
Výsledky a vstupy se uchovávají 30 dní. Co chceš mít navždy, stáhni si do vlastního úložiště.

Začni tvořit s Mage

Jeden účet, jeden zůstatek Gems, všechny modely. Platíš jen za to, co vygeneruješ.