API do Mage · Modelo de imagem

API do Guava

Fotorrealismo que passa por fotografia

Obter uma chave de APIExperimente o Guava no playground
POST https://api.mage.space/v1/guava/generate

Resumo rápido

A API do Guava executa o Guava e mais 4 variantes pelo Mage em POST https://api.mage.space/v1/guava/generate. Uma solicitação nas configurações padrão custa 37 Gems (cerca de US$ 0,037), sem assinatura. O Guava aceita personagens e referências salvos, chamados por @handle no prompt.

Visão geral

O que a API do Guava faz

Nossa família de fotorrealismo, para retratos, moda e fotos de produto com pele, tecido e luz fiéis à realidade. Aceita referências ou Characters, até 2K.

A família de fotorrealismo do Mage, para retratos, moda e fotos de produto que parecem fotografias, com imagens de referência. Guava 2 e Guava 2 Pro são o par atual.

Aceita image e additional_images como entradas.

Início rápido

Chame a API do Guava

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

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/guava/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": "guava"
}' | 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('guava', {
  prompt: 'Editorial portrait in soft daylight, 35mm film look',
  aspect_ratio: '4:5',
  model_id: 'guava',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("guava", {
    "prompt": "Editorial portrait in soft daylight, 35mm film look",
    "aspect_ratio": "4:5",
    "model_id": "guava",
})

print(request["result"]["url"])

Modelos

Valores de model_id do Guava

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

model_idNomePadrão
guavaGuavaSim
guava-proGuava Pro
guava-pro-v1-5Guava Pro 1.5
guava-2Guava 2
guava-2-proGuava 2 Pro

Opções

Parâmetros do Guava

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
resolution1K, 2K

Entradas

Entradas de mídia aceitas pelo Guava

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

CampoFunção
imageA imagem de referência.
additional_imagesImagens de referência adicionais.

Mais modelos de imagem

Outras APIs de geração de imagens no Mage

Imagem · a partir de 20 Gems

API do HiDream

Rápido e versátil, com prompts negativos

Imagem · a partir de 20 Gems

API do Krea 2

Estética deslumbrante em segundos

Imagem · a partir de 135 Gems

API do Mango

Nossa família de imagens principal

Imagem · a partir de 68 Gems

API do Nano Banana 2

Texto nítido e legível, até 4K

Imagem · a partir de 15 Gems

API do SDXL Plus

SDXL com rostos e mãos corrigidos

Imagem · a partir de 10 Gems

API do Stable Diffusion v1.5

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

Perguntas frequentes

Perguntas frequentes

Quanto custa a API do Guava?

Uma solicitação do Guava com as configurações padrão (Guava) custa 37 Gems, cerca de US$ 0,037. 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 Guava?

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

Quais modelos do Guava posso chamar?

guava (Guava), guava-pro (Guava Pro), guava-pro-v1-5 (Guava Pro 1.5), guava-2 (Guava 2), guava-2-pro (Guava 2 Pro). O padrão é o Guava.

O Guava aceita imagens de referência ou personagens?

O Guava aceita image e additional_images. O Guava aceita personagens e referências salvos por @handle no prompt.

Posso usar o Guava pelo Claude ou pelo ChatGPT?

Sim. Conecte o servidor MCP do Mage ao Claude, ChatGPT, Claude Code, Grok ou Cursor e peça o Guava 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 Guava 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 Guava no playground

Relacionados