Una clave, todos los modelos
28 modelos de imagen, vídeo y audio en una sola API REST y un único saldo de Gems. Cambia de modelo modificando la ruta de la URL.
De un vistazo
Mage ofrece a los desarrolladores una API REST en https://api.mage.space/v1 y un servidor MCP remoto en https://mcp.mage.space/mcp. Ambos ejecutan los mismos 28 modelos de imagen, vídeo y audio, incluidos Mango 3 y Cherry 2 Pro, exclusivos de Mage, con una sola cuenta, y cada generación se paga con Gems, sin suscripción.
28
Modelos
3
Tipos de contenido
16
Herramientas MCP
$0
Cuota mensual
Formas de empezar
Úsalo desde código, tu asistente o ComfyUI
API REST
La API de Mage
Envía generaciones desde tu propio código con una clave. Solicitudes asíncronas, reintentos idempotentes, subidas de hasta 100 MB y 20 generaciones en curso.
SDK
SDK de TypeScript y Python
Clientes oficiales y tipados que envían, esperan el resultado, reintentan con seguridad y suben archivos en pocas líneas.
Servidor MCP
El servidor MCP de Mage
Conecta Claude, ChatGPT, Claude Code, Grok o Cursor con un inicio de sesión y pide imágenes, vídeo y audio con palabras normales.
ComfyUI
Mage para ComfyUI
Mango, Cherry, Seed Audio y todos los demás modelos de Mage como nodos de ComfyUI. Sin GPU ni descargas de modelos.
Por tipo de contenido
API de generación
15 modelos
API de generación de imágenes con IA
Texto a imagen, edición y personajes coherentes hasta 4K.
12 modelos
API de generación de vídeo con IA
Texto a vídeo, imagen a vídeo, fotogramas, referencias y sonido.
1 modelo
API de generación de audio con IA
Voces, narración, música y efectos de sonido a partir de un prompt.
Inicio rápido
Tu primera generación
Crea una clave en API → API Keys, expórtala como MAGE_API_KEY y ejecuta uno de estos ejemplos.
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-v3"
}' | 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-v3',
});
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-v3",
})
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.
MCP
Mage en tu asistente de IA
Mage en Claude
Genera imágenes, vídeo y audio en Claude para web, en la app de escritorio, en las apps móviles y en Cowork.
Mage en ChatGPT
Genera imágenes, vídeo y audio en ChatGPT como una app MCP personal.
Mage en Claude Code
Genera imágenes, vídeo y audio en Claude Code, desde tu terminal y tu editor.
Mage en Grok
Genera imágenes, vídeo y audio en Grok como conector personalizado.
Mage en Cursor
Genera imágenes, vídeo y audio en el modo Agent de Cursor.
Modelos
Modelos destacados
Imagen · desde 40 Gems
API de Flux 2
Prompts largos y ediciones con varias referencias
Imagen · desde 9 Gems
API de GPT Image 2
Prompts precisos y texto legible
Imagen · desde 37 Gems
API de Guava
Fotorrealismo que parece una fotografía
Imagen · desde 135 Gems
API de Mango
Nuestra familia de imágenes insignia
Imagen · desde 68 Gems
API de Nano Banana 2
Texto nítido y legible, hasta 4K
Vídeo · desde 618 Gems
API de Cherry
Nuestra familia de vídeo insignia
Vídeo · desde 245 Gems
API de Lemon
Todas las funciones de vídeo, a un precio más amable
Vídeo · desde 338 Gems
API de Plum
Sonido en cada clip, hasta 2K
Audio · desde 19 Gems
API de Seed Audio
Voces, música y efectos de sonido con un solo prompt
Pensada para producción
Lo que obtiene cada solicitud a la API de Mage
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.
Preguntas frecuentes
Preguntas frecuentes
¿Qué es la API de Mage?
La API de Mage es una API REST en https://api.mage.space/v1 para generar imágenes, vídeo y audio con 28 modelos desde tu propio código. Las solicitudes son asíncronas y se pagan por generación en Gems.
¿Qué es el servidor MCP de Mage?
Un servidor remoto de Model Context Protocol en https://mcp.mage.space/mcp que permite a los asistentes de IA generar imágenes, vídeo y audio en tu cuenta de Mage. Le da al asistente 16 herramientas para elegir un modelo, consultar el precio, generar, esperar el resultado y usar tus personajes, referencias e historial guardados.
¿Necesito una clave de API para usar el servidor MCP?
No. Claude, ChatGPT, Grok, Cursor y Claude Code se conectan iniciando sesión en Mage mediante OAuth. La clave de API es opcional, para configuraciones sin interfaz como CI.
¿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.