API de Mage · Modelo de imagen
API de Guava
Fotorrealismo que parece una fotografía
POST https://api.mage.space/v1/guava/generateDe un vistazo
La API de Guava ejecuta Guava y otras 4 variantes a través de Mage en POST https://api.mage.space/v1/guava/generate. Una solicitud con los ajustes predeterminados cuesta 37 Gems (unos $0.037), sin suscripción. Guava admite personajes y referencias guardados mediante @handle en el prompt.
- ImagenResultado
- 5Variantes
- 37Gems por imagen, por defecto
- $0.037Aprox., en USD
Resumen
Qué hace la API de Guava
Nuestra familia de fotorrealismo, para retratos, moda y fotos de producto con piel, tejidos y luz como en la vida real. Admite referencias o Characters, hasta 2K.
La familia de fotorrealismo de Mage, para retratos, moda y fotos de producto que parecen fotografías, con imágenes de referencia. Guava 2 y Guava 2 Pro son la pareja actual.
Acepta image y additional_images como entradas.
Inicio rápido
Llama a la API de Guava
Define MAGE_API_KEY, envía la solicitud a /guava/generate y consulta status_url hasta que se complete.
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 de Guava
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| guava | Guava | Sí |
| guava-pro | Guava Pro | |
| guava-pro-v1-5 | Guava Pro 1.5 | |
| guava-2 | Guava 2 | |
| guava-2-pro | Guava 2 Pro |
Opciones
Parámetros de Guava
Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.
| Campo | Valores |
|---|---|
| aspect_ratio | 21:9, 16:9, 3:2, 5:4, 1:1, 4:5, 2:3, 9:16, 9:21 |
| resolution | 1K, 2K |
Entradas
Entradas multimedia que acepta Guava
Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.
| Campo | Rol |
|---|---|
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
Más modelos de imagen
Otras API de generación de imágenes en Mage
API de HiDream
Rápido y versátil, con prompts negativos
Krea 2 API
Una estética espectacular en segundos
API de Mango
Nuestra familia de imágenes insignia
API de MiniMax H3 Image
Imágenes nativas de 16 megapíxeles, pesos abiertos
API de MOSS-Image
Prompts largos y texto bilingüe, pesos abiertos
API de Nano Banana 2
Texto nítido y legible, hasta 4K
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Guava?
¿Cuál es el endpoint de la API de Guava?
¿Qué modelos de Guava puedo usar?
¿Guava admite imágenes de referencia o personajes?
¿Puedo usar Guava desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Guava?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.