API de Mage · Modelo de imagen
API de Mango
Nuestra familia de imágenes insignia
POST https://api.mage.space/v1/mango/generateDe un vistazo
La API de Mango ejecuta Mango 4 y otras 5 variantes a través de Mage en POST https://api.mage.space/v1/mango/generate. Una solicitud con los ajustes predeterminados cuesta 42 Gems (unos 0,042 $), sin suscripción. Mango admite personajes guardados y referencias mediante @handle en el prompt.
- ImagenResultado
- 6Variantes
- 42Gems por imagen, por defecto
- $0.042Aprox., en USD
Resumen
Qué hace la API de Mango
Nuestra familia de imágenes para personajes coherentes, ediciones precisas y escenas que combinan muchas referencias o Characters. Mango 4 lidera la familia, con la luz y la piel más realistas y el texto pequeño más nítido; Mango 3 Turbo hace borradores a precio fijo, referencias incluidas, y Mango 3S llega a 3K.
La familia insignia de imágenes de Mage, para personajes coherentes, ediciones precisas y escenas que combinan muchas referencias. Mango 4 (`mango-v4`) es el predeterminado y el más reciente, con la luz y la piel más realistas y el texto pequeño más nítido; Mango 3 (`mango-v3`) es el anterior modelo insignia; Mango 3 Turbo (`mango-v3-turbo`) hace borradores a precio fijo, referencias incluidas, y Mango 3S (`mango-v3s`) llega a 3K.
Acepta image y additional_images como entradas.
Inicio rápido
Llama a la API de Mango
Define MAGE_API_KEY, envía la solicitud a /mango/generate y consulta status_url hasta que la solicitud se complete.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/mango/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": "mango-v4"
}' | 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('mango', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'mango-v4',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("mango", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "mango-v4",
})
print(request["result"]["url"])Modelos
Valores de model_id de Mango
Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.
| model_id | Nombre | Predeterminado |
|---|---|---|
| mango | Mango | |
| mango-v2 | Mango 2 | |
| mango-v3s | Mango 3S | |
| mango-v3 | Mango 3 | |
| mango-v3-turbo | Mango 3 Turbo | |
| mango-v4 | Mango 4 | Sí |
Opciones
Parámetros de Mango
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, 3K, 4K |
Entradas
Entradas multimedia que admite Mango
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 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
API de SDXL Plus
SDXL con rostros y manos corregidos
API de Seedream
Seedream, con un filtro estricto
API de Stable Diffusion v1.5
El clásico, a bajo costo
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Mango?
¿Cuál es el endpoint de la API de Mango?
¿Qué modelos de Mango puedo llamar?
¿Mango admite imágenes de referencia o personajes?
¿Puedo usar Mango desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Mango?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.