Pular para o conteúdo

API do Mage · Modelo de imagem

API do Stable Diffusion XL

SDXL ajustado para fotorrealismo

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.

  • ImagemSaída
  • 1Variante
  • 10Gems por imagem, padrão
  • $0.01Aproximadamente, em USD

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 90 Gems

    API do Grok Image

    Grok Imagine, em dois níveis

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.

CharactersComunidade