API do Mage · Modelo de imagem

API do SDXL Plus

SDXL com rostos e mãos corrigidos

Obter uma chave de APIExperimente o SDXL Plus no playground
POST https://api.mage.space/v1/sdxl_plus/generate

Resumo rápido

A API do SDXL Plus executa o SDXL Plus pelo Mage em POST https://api.mage.space/v1/sdxl_plus/generate. Uma requisição com as configurações padrão custa 15 Gems (cerca de US$ 0,015), sem assinatura. O SDXL Plus não aceita menções com @handle.

Visão geral

O que a API do SDXL Plus faz

Nosso pipeline SDXL de alto detalhe com correção automática de rostos e mãos. Texto para imagem ou a partir de uma imagem de entrada; mais lento que o SDXL comum, mas vale a pena.

O pipeline SDXL de alto detalhe do Mage com correção automática de rostos e mãos, com imagem de entrada opcional.

Aceita image como entrada.

Início rápido

Chame a API do SDXL Plus

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

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

Modelos

Valores de model_id do SDXL Plus

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

model_idNomePadrão
6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80SDXL PlusSim

Opções

Parâmetros do SDXL Plus

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 SDXL Plus

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 Stable Diffusion v1.5

O clássico, com preço econômico

Imagem · a partir de 10 Gems

API do Stable Diffusion v3.5 Large

O Stable Diffusion que melhor entende você

Imagem · a partir de 10 Gems

API do Stable Diffusion XL

SDXL ajustado para fotorrealismo

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

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do SDXL Plus?

Uma requisição do SDXL Plus com as configurações padrão (SDXL Plus) custa 15 Gems, cerca de US$ 0,015. 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 SDXL Plus?

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

Quais modelos do SDXL Plus posso chamar?

6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80. O padrão é SDXL Plus.

O SDXL Plus aceita imagens de referência ou personagens?

O SDXL Plus aceita image. Ele não aceita menções com @handle.

Posso usar o SDXL Plus no Claude ou no ChatGPT?

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

Por quanto tempo os resultados do SDXL Plus ficam salvos?

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 SDXL Plus no playground

Relacionados