API de Mage · Modelo de imagen

API de Stable Diffusion XL

SDXL ajustado para fotorrealismo

Obtén una clave de APIPrueba Stable Diffusion XL en el playground
POST https://api.mage.space/v1/stable_diffusion_xl/generate

De un vistazo

La API de Stable Diffusion XL ejecuta Stable Diffusion XL a través de Mage en POST https://api.mage.space/v1/stable_diffusion_xl/generate. Una solicitud con los ajustes por defecto cuesta 10 Gems (unos 0,01 $), sin suscripción. Stable Diffusion XL no admite menciones con @handle.

Resumen

Qué hace la API de Stable Diffusion XL

El clásico Stable Diffusion XL, ajustado para lograr resultados fotorrealistas. De texto a imagen o a partir de una imagen de entrada, a un precio económico.

Stable Diffusion XL, ajustado para lograr resultados fotorrealistas, con una imagen de entrada opcional.

Acepta image como entrada.

Inicio rápido

Llama a la API de Stable Diffusion XL

Define MAGE_API_KEY, envía la solicitud a /stable_diffusion_xl/generate y consulta status_url hasta que la solicitud se complete.

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

Modelos

Valores de model_id de Stable Diffusion XL

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLSí

Opciones

Parámetros de Stable Diffusion XL

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

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

Entradas

Entradas multimedia que acepta Stable Diffusion XL

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

CampoRol
imageLa imagen de referencia.

Más modelos de imagen

Otras API de generación de imágenes en Mage

Imagen · desde 10 Gems

API de Z-Image

El modelo de imágenes más rápido de Mage

Imagen · desde 20 Gems

API de Anima

Hecho a medida para anime

Imagen · desde 35 Gems

API de Chroma

Pesos abiertos, basado en Flux

Imagen · desde 40 Gems

API de Flux 2

Prompts largos y ediciones con varias referencias

Imagen · desde 9 Gems

API de GPT Image 2

Prompts precisos y texto legible

Imagen · desde 75 Gems

API de Grok Image

Grok Imagine, en tres niveles de calidad

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Stable Diffusion XL?

Una solicitud de Stable Diffusion XL con los ajustes predeterminados (Stable Diffusion XL) cuesta 10 Gems, unos 0,01 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se te reembolsa; si la bloquea la política de contenido de Mage, no.

¿Cuál es el endpoint de la API de Stable Diffusion XL?

POST https://api.mage.space/v1/stable_diffusion_xl/generate con un encabezado Authorization: Bearer que lleve tu clave de API de Mage. La respuesta incluye una status_url que puedes consultar periódicamente para obtener el resultado.

¿Qué modelos de Stable Diffusion XL puedo usar?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. El predeterminado es Stable Diffusion XL.

¿Stable Diffusion XL admite imágenes de referencia o personajes?

Stable Diffusion XL acepta image. Stable Diffusion XL no admite menciones con @handle.

¿Puedo usar Stable Diffusion XL desde Claude o ChatGPT?

Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Stable Diffusion XL por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.

¿Cuánto tiempo se conservan los resultados de Stable Diffusion XL?

Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

Obtén una clave de APIPrueba Stable Diffusion XL en el playground

Relacionado