Mage API · Модель изображений

API Stable Diffusion XL

SDXL, настроенная на фотореализм

Получить API-ключПопробуйте Stable Diffusion XL в Playground
POST https://api.mage.space/v1/stable_diffusion_xl/generate

Главное

API Stable Diffusion XL запускает Stable Diffusion XL через Mage по адресу POST https://api.mage.space/v1/stable_diffusion_xl/generate. Запрос с настройками по умолчанию стоит 10 Gems (около $0,01), подписка не нужна. Упоминания @handle в Stable Diffusion XL не поддерживаются.

Обзор

Что умеет API Stable Diffusion XL

Классическая Stable Diffusion XL, настроенная на фотореалистичный результат. Генерация по тексту или по одному исходному изображению по доступной цене.

Stable Diffusion XL, настроенная на фотореалистичный результат, с возможностью добавить исходное изображение.

На вход принимает image.

Быстрый старт

Вызов API Stable Diffusion XL

Задайте MAGE_API_KEY, отправьте запрос на /stable_diffusion_xl/generate и опрашивайте status_url, пока запрос не завершится.

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

Модели

Значения model_id для Stable Diffusion XL

Передайте model_id, чтобы выбрать вариант. Запрос без него использует вариант по умолчанию.

model_idНазваниеПо умолчанию
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLДа

Параметры

Параметры Stable Diffusion XL

Допустимые значения для всех вариантов; у отдельного варианта их может быть меньше. Параметры каждого варианта перечислены в документации.

ПолеЗначения
aspect_ratio21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21

Входные данные

Какие медиафайлы принимает Stable Diffusion XL

Передавайте каждый файл как https-ссылку, data URL или загрузку размером до 100 МБ.

ПолеРоль
imageРеференсное изображение.

Другие модели изображений

Другие API для генерации изображений на Mage

Изображение · от 10 Gems

Z-Image API

Самая быстрая модель для изображений в Mage

Изображение · от 20 Gems

Anima API

Создана специально для аниме

Изображение · от 35 Gems

Chroma API

Открытые веса, на базе Flux

Изображения · от 40 Gems

Flux 2 API

Длинные промпты и правки по нескольким референсам

Изображения · от 9 Gems

GPT Image 2 API

Точные промпты и читаемый текст

Изображение · от 75 Gems

Grok Image API

Grok Imagine, три уровня качества

FAQ

Частые вопросы

Сколько стоит Stable Diffusion XL API?

Запрос к Stable Diffusion XL с настройками по умолчанию (Stable Diffusion XL) стоит 10 Gems, около $0,01. Другие разрешения, длительность и варианты меняют цену; точную стоимость показывает ответ. Если генерация не удалась, Gems возвращаются; если её заблокировала политика контента Mage — нет.

Какой эндпоинт у Stable Diffusion XL API?

Отправьте POST на https://api.mage.space/v1/stable_diffusion_xl/generate с заголовком Authorization: Bearer и вашим API-ключом Mage. В ответе приходит status_url — опрашивайте его, чтобы получить результат.

Какие модели Stable Diffusion XL можно вызывать?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. По умолчанию используется Stable Diffusion XL.

Поддерживает ли Stable Diffusion XL референсные изображения или персонажей?

Stable Diffusion XL принимает image. Упоминания @handle в Stable Diffusion XL не поддерживаются.

Можно ли использовать Stable Diffusion XL в Claude или ChatGPT?

Да. Подключите MCP-сервер Mage к Claude, ChatGPT, Claude Code, Grok или Cursor и просто назовите Stable Diffusion XL. Ассистент считывает параметры модели через get_model и называет цену до генерации.

Как долго хранятся результаты Stable Diffusion XL?

Результаты и входные файлы хранятся 30 дней. Всё, что нужно сохранить, скачайте в своё хранилище.

Начните создавать с Mage

Один аккаунт, один баланс Gems, все модели. Платите только за то, что генерируете.

Получить API-ключПопробуйте Stable Diffusion XL в Playground

Похожие материалы