API do Mage · Modelo de imagem

API do Stable Diffusion XL

SDXL ajustado para fotorrealismo

Obter uma chave de APIExperimente o Stable Diffusion XL no playground
POST https://api.mage.space/v1/stable_diffusion_xl/generate

Resumo rápido

A API do Stable Diffusion XL executa o Stable Diffusion XL pelo Mage em POST https://api.mage.space/v1/stable_diffusion_xl/generate. Uma requisição nas configurações padrão custa 10 Gems (cerca de US$ 0,01), sem assinatura. O Stable Diffusion XL não aceita menções com @handle.

Visão geral

O que a API do Stable Diffusion XL faz

O clássico Stable Diffusion XL, ajustado para resultados fotorrealistas. Texto para imagem ou a partir de uma imagem de entrada, com preço acessível.

Stable Diffusion XL, ajustado para resultados fotorrealistas, com imagem de entrada opcional.

Aceita image como entrada.

Início rápido

Chame a API do Stable Diffusion XL

Defina MAGE_API_KEY, envie para /stable_diffusion_xl/generate e consulte o status_url até a requisição ser concluída.

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 do Stable Diffusion XL

Envie model_id para escolher uma variante. Uma solicitação sem ele usa a padrão.

model_idNomePadrão
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80Stable Diffusion XLSim

Opções

Parâmetros do Stable Diffusion XL

Valores permitidos em todas as variantes; uma variante pode oferecer menos. A documentação lista as opções 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 de mídia aceitas pelo Stable Diffusion XL

Envie cada uma como URL https, data URL ou upload de até 100 MB.

CampoFunção
imageA imagem de referência.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Imagem · a partir de 10 Gems

API do Z-Image

O modelo de imagem mais rápido do Mage

Imagem · a partir de 20 Gems

API do Anima

Feito sob medida para anime

Imagem · a partir de 35 Gems

API do Chroma

Pesos abertos, baseado no Flux

Imagem · a partir de 40 Gems

API do Flux 2

Prompts longos e edições com várias referências

Imagem · a partir de 9 Gems

API do GPT Image 2

Prompts precisos e texto legível

Imagem · a partir de 75 Gems

API do Grok Image

Grok Imagine, em três níveis de qualidade

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Stable Diffusion XL?

Uma requisição do Stable Diffusion XL com as configurações padrão (Stable Diffusion XL) custa 10 Gems, cerca de US$ 0,01. Outras resoluções, durações e variantes alteram o preço; a resposta informa o valor exato cobrado. Uma geração que falha é reembolsada; uma bloqueada pela política de conteúdo do Mage não é.

Qual é o endpoint da API do Stable Diffusion XL?

Use POST https://api.mage.space/v1/stable_diffusion_xl/generate com um cabeçalho Authorization: Bearer contendo sua chave de API do Mage. A resposta inclui uma status_url para você consultar o resultado.

Quais modelos do Stable Diffusion XL posso chamar?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. O padrão é Stable Diffusion XL.

O Stable Diffusion XL aceita imagens de referência ou personagens?

O Stable Diffusion XL aceita image. O Stable Diffusion XL não aceita menções com @handle.

Posso usar o Stable Diffusion XL no Claude ou no ChatGPT?

Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça pelo nome Stable Diffusion XL. Seu assistente lê as opções com get_model e informa o preço antes de gerar.

Por quanto tempo os resultados do Stable Diffusion XL ficam guardados?

Resultados e entradas ficam salvos por 30 dias. Baixe o que quiser guardar para o seu próprio armazenamento.

Comece a criar com o Mage

Uma conta, um saldo de Gems, todos os modelos. Pague apenas pelo que você gerar.

Obter uma chave de APIExperimente o Stable Diffusion XL no playground

Relacionados