API de Mage · Generación de imágenes
La API de generación de imágenes con IA para todos los modelos
Texto a imagen, edición de imágenes y personajes consistentes con 18 modelos, incluido Mango 4, el modelo estrella de Mage, con una sola clave y un único saldo.
POST https://api.mage.space/v1/{model}/generateDe un vistazo
La API de generación de imágenes de Mage es una API REST en https://api.mage.space/v1 que ejecuta 18 modelos de texto a imagen y edición de imágenes, entre ellos Mango 4, Guava 2 Pro, GPT Image 2.6, Nano Banana 2, Flux 2 y Krea 2. Envías un prompt con POST a /{model}/generate, consultas el estado de la solicitud y descargas la imagen. Cada imagen se paga con Gems, sin suscripción.
- 18modelos de imágenes
- $0.009Opción predeterminada más barata, por imagen
- 20Generaciones simultáneas
- $0Cuota mensual
Modelos
Todos los modelos de imágenes de la API de Mage
Los precios son por generación, en Gems. 1.000 Gems cuestan 1 USD en el paquete estándar, y los paquetes más grandes incluyen Gems extra. El precio depende del modelo, la resolución y la duración; se muestra el precio con los ajustes predeterminados, y cada respuesta indica el cargo exacto en billing.gems_charged. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
| Modelo | Ideal para | Valores de model_id | Precio predeterminado |
|---|---|---|---|
| Anima | Diseñado específicamente para anime | anima-v1 | 20 Gems ($0.02) |
| Chroma | Pesos abiertos, basado en Flux | chroma-v1-hd | 35 Gems ($0.035) |
| Flux 2 | Prompts largos y ediciones con varias referencias | flux2-dev | 40 Gems ($0.04) |
| GPT Image 2 | Prompts precisos y texto legible | gpt-image-2, gpt-image-2.5-flare, gpt-image-2.5-sunburst, gpt-image-2.6-flare, gpt-image-2.6-sunburst | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, en dos niveles | grok-imagine-image, grok-imagine-image-2.0 | 90 Gems ($0.09) |
| Guava | Fotorrealismo que parece una fotografía | guava, guava-pro, guava-pro-v1-5, guava-2, guava-2-pro | 37 Gems ($0.037) |
| HiDream | Rápido y versátil, con prompts negativos | hidream-fast | 20 Gems ($0.02) |
| Krea 2 | Estética espectacular en segundos | krea-2-turbo | 20 Gems ($0.02) |
| Mango | Nuestra familia estrella de imágenes | mango, mango-v2, mango-v3s, mango-v3, mango-v3-turbo, mango-v4 | 42 Gems ($0.042) |
| MiniMax H3 Image | Imágenes nativas de 16 megapíxeles, pesos abiertos | minimax-h3-image | 15 Gems ($0.015) |
| MOSS-Image | Prompts largos y texto bilingüe, pesos abiertos | moss-image | 25 Gems ($0.025) |
| Nano Banana 2 | Texto nítido y legible, hasta 4K | nano-banana-v2, nano-banana-v2.1 | 51 Gems ($0.051) |
| SDXL Plus | SDXL con rostros y manos corregidos | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| Seedream | Seedream, con un filtro estricto | seedream-4.0, seedream-4.5, seedream-5.0-lite, seedream-5.0-pro, seedream-5.0-flash, seedream-5.5 | 42 Gems ($0.042) |
| Stable Diffusion v1.5 | El clásico, a bajo costo | 15012C538F503CE2EBFC2C8547B268C75CCDAFF7A281DB55399940FF1D70E21D | 10 Gems ($0.01) |
| Stable Diffusion v3.5 Large | El Stable Diffusion que mejor sigue tus indicaciones | sd-3-5-large | 10 Gems ($0.01) |
| Stable Diffusion XL | SDXL ajustado para fotorrealismo | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 10 Gems ($0.01) |
| Z-Image | El modelo de imágenes más rápido de Mage | z-image-turbo | 10 Gems ($0.01) |
Inicio rápido
Genera una imagen con Anima v1
Define MAGE_API_KEY, envía la solicitud y consulta el estado hasta que termine. Cambia anima en la URL por cualquier modelo de los de arriba.
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/anima/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": "anima-v1"
}' | 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('anima', {
prompt: 'Editorial portrait in soft daylight, 35mm film look',
aspect_ratio: '4:5',
model_id: 'anima-v1',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("anima", {
"prompt": "Editorial portrait in soft daylight, 35mm film look",
"aspect_ratio": "4:5",
"model_id": "anima-v1",
})
print(request["result"]["url"])Cómo funciona
De la clave de API al contenido final en tres llamadas
Todos los modelos comparten un único esquema de autenticación, un mismo ciclo de solicitudes asíncronas y los mismos nombres de campo.
Crea una clave de API
Inicia sesión en Mage, abre API → API Keys y crea una clave. Empieza por mage_sk_ y se muestra una sola vez. Una cuenta puede tener 10 claves activas.
Envía una generación
Haz un POST con un cuerpo JSON a https://api.mage.space/v1/{model}/generate con una cabecera Authorization: Bearer. La respuesta llega al instante con un request_id, un status y una status_url. Envía una cabecera Idempotency-Key para que un reintento nunca se cobre dos veces.
Consulta y descarga
Consulta status_url hasta que el estado sea completed, failed o cancelled. Una solicitud completada incluye result.url con el archivo de imagen, vídeo o audio, que se conserva 30 días.
Pensada para producción
Lo que obtiene cada solicitud a la API de Mage
Una clave, todos los modelos
37 modelos de imagen, video y audio con una sola API REST y un único saldo de Gems. Cambia de modelo modificando la ruta de la URL.
Paga por generación
Sin suscripción ni gasto mínimo. Compras Gems y cada solicitud se cobra a su precio indicado. Si una generación falla, se reembolsa, salvo que la política de contenido de Mage la haya bloqueado.
Reintentos seguros
Las claves de idempotencia hacen que un reenvío devuelva la solicitud original sin volver a cobrar.
Personajes coherentes
Guarda un personaje o una referencia una vez y escribe @handle en cualquier prompt para usarlo con todos los modelos compatibles.
Entradas de gran tamaño
Envía entradas de imagen, vídeo y audio como URL o data URL, o sube archivos de hasta 100 MB mediante una subida firmada.
20 generaciones en curso
Cada cuenta puede ejecutar 20 generaciones a la vez, y el límite se puede ampliar según tu caso de uso. Las solicitudes rechazadas nunca se cobran.
Casos de uso
Qué crean los desarrolladores con la API de imágenes
Imágenes de producto y marketing
Crea fotos de producto, variantes de anuncios y publicaciones para redes sociales al instante, con texto legible gracias a GPT Image 2.6 o Nano Banana 2.
Personajes coherentes
Guarda un personaje una vez y mantén la misma cara en todo un conjunto con Mango 4, Guava 2 Pro y otros modelos que admiten menciones con @handle.
Flujos de edición de imágenes
Envía una imagen de origen con una instrucción para cambiar justo lo que pides y dejar todo lo demás en su sitio.
Apps y juegos
Genera avatares, stickers, cartas y escenas dentro de tu producto sin alojar ni una sola GPU.
Retratos fotorrealistas
Guava 2 Pro crea retratos, moda y fotos de estilo de vida con piel, tejidos y luz de aspecto real.
Borradores rápidos a gran escala
Z-Image Turbo y Krea 2 mantienen los precios bajos para miniaturas en gran volumen y primeras versiones.
Preguntas frecuentes
Preguntas frecuentes
¿Cuál es la mejor API de generación de imágenes con IA?
¿La API de imágenes admite edición de imágenes e imágenes de referencia?
¿Qué resoluciones admite la API de imágenes?
¿Cuánto cuesta la API de Mage?
¿Necesito una membresía de Mage para usar la API?
¿Puedo usar comercialmente los resultados de la API?
¿Cuáles son los límites de uso?
¿Puede mi agente de IA usar la API de Mage?
¿Hay un SDK para la API de Mage?
Ya uso otra API de generación. ¿Qué tengo que cambiar?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.