De un vistazo
La API de Mage ejecuta 15 modelos de imagen, 12 de vídeo y 1 de audio en https://api.mage.space/v1/{model}/generate. Todos los modelos usan la misma clave, el mismo ciclo de solicitud y los mismos nombres de campo, y se pagan por generación en Gems.
15
Modelos de imagen
12
Modelos de vídeo
1
Modelos de audio
1
Una clave de API para todos
Modelos de imagen
Modelos de generación de imágenes
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 | 9 Gems ($0.009) |
| Grok Image | Grok Imagine, en tres niveles de calidad | grok-imagine-image, grok-imagine-image-quality, grok-imagine-image-2.0 | 75 Gems ($0.075) |
| 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 | 135 Gems ($0.135) |
| Nano Banana 2 | Texto nítido y legible, hasta 4K | nano-banana-v2 | 68 Gems ($0.068) |
| SDXL Plus | SDXL con rostros y manos corregidos | 6A35A7855770AE9820A3C931D4964C3817B6D9E3C6F9C4DABB5B3A94E5643B80 | 15 Gems ($0.015) |
| 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) |
Modelos de vídeo
Modelos de generación de vídeo
| Modelo | Ideal para | Valores de model_id | Precio predeterminado |
|---|---|---|---|
| Berry | Video fiel a tus referencias | berry, berry-2 | 189 Gems ($0.189) |
| Blueberry | Fija el primer y el último fotograma | blueberry, blueberry-v2 | 360 Gems ($0.36) |
| Cherry | Nuestra familia de video estrella | cherry-mini, cherry, cherry-pro, cherry-2-pro | 618 Gems ($0.618) |
| Grok Video | Grok Imagine, en movimiento | grok-imagine-video | 375 Gems ($0.375) |
| Kiwi | Video para el día a día, sin configuración | kiwi | 270 Gems ($0.27) |
| Lemon | Todas las funciones de video, a un precio más amable | lemon | 245 Gems ($0.245) |
| LTX Video | Video rápido de pesos abiertos para iterar | ltx-video-096-distilled, ltx-video-096-dev | 20 Gems ($0.02) |
| Melon | Anime en movimiento, con audio opcional | melon, melon-pro | 147 Gems ($0.147) |
| MiniMax-H3 | Video abierto y rápido con sonido estéreo | minimax-h3-turbo, minimax-h3 | 30 Gems ($0.03) |
| Plum | Sonido en cada clip, hasta 2K | plum, plum-max | 338 Gems ($0.338) |
| Raspberry | Personajes que cobran vida desde un primer fotograma | raspberry | 360 Gems ($0.36) |
| Wan Video v2.2 | Video de pesos abiertos con una variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
Modelos de audio
Modelos de generación de audio
| Modelo | Ideal para | Valores de model_id | Precio predeterminado |
|---|---|---|---|
| Seed Audio | Voces, música y efectos de sonido desde un solo prompt | seed-audio-1.0 | 19 Gems ($0.019) |
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Mage?
No hay suscripción ni cuota mensual. Cada generación se paga en Gems al precio indicado de su modelo, y 1000 Gems cuestan 1 $ en el paquete estándar. La página de cada modelo muestra su precio con la configuración por defecto, y cada respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la política de contenido de Mage la bloquea, no. Una solicitud que tu saldo no pueda cubrir se rechaza antes de cobrar nada.
¿Necesito una membresía de Mage para usar la API?
No. La API funciona solo con Gems. Los planes de membresía y su generación ilimitada dentro de la app no se aplican a las solicitudes de la API, así que cualquier cuenta de Mage con Gems puede usarla.
¿Puedo usar comercialmente los resultados de la API?
Sí. El contenido que creas con Mage, también a través de la API y el servidor MCP, se puede usar con fines comerciales. Se agradece la atribución, pero no es obligatoria.
¿Cuáles son los límites de uso?
Una cuenta puede tener 20 generaciones en cola o en curso a la vez. Un envío que supere ese límite se rechaza con un 429 y no cuesta nada. Escribe a [email protected] para ampliar el límite según tu caso de uso.
¿Puede mi agente de IA usar la API de Mage?
Sí. Los agentes pueden llamar a la API REST con una clave o conectarse al servidor MCP de Mage, que ofrece a Claude, ChatGPT, Claude Code, Grok y Cursor dieciséis herramientas listas para usar para elegir un modelo, consultar el precio, generar y obtener el resultado. Consulta el servidor MCP.
¿Hay un SDK para la API de Mage?
Sí. El paquete oficial @mage-space/sdk en npm y mage-space en PyPI son de código abierto y tienen tipado para cada modelo. Envían la solicitud, esperan el resultado, reintentan de forma segura y suben archivos por ti. Los usuarios de ComfyUI pueden instalar el paquete de nodos comfyui-mage. Consulta los SDK de Mage.
Ya uso otra API de generación. ¿Qué tengo que cambiar?
Apunta tu cliente a https://api.mage.space/v1, envía tu clave de Mage como token Bearer y asigna tus campos a los de la página del modelo: prompt, aspect_ratio, resolution, duration y model_id funcionan igual en todos los modelos de Mage. Las solicitudes son asíncronas, así que envíala y luego consulta status_url.
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.