API de Mage · Pensada para tu próxima idea
Una API. Posibilidades infinitas.
Lleva lo mejor de Mage a tu producto y a tu asistente de IA. Genera imágenes, vídeo y audio con una sola clave de API o una sola conexión MCP.
https://api.mage.space/v1De 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 37 modelos de imagen, video y audio, incluidos Mango 4 y Cherry 2 Pro, exclusivos de Mage, con una sola cuenta. Cada generación se paga con Gems, sin suscripción.
- 37Modelos
- 3Tipos de contenido
- 16Herramientas MCP
- $0Cuota mensual
Formas de empezar
Úsalo desde código, tu asistente o ComfyUI
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 de TypeScript y Python
Clientes oficiales y tipados que envían, esperan el resultado, reintentan con seguridad y suben archivos en pocas líneas.
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.
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
API de generación de imágenes con IA
Texto a imagen, edición y personajes coherentes hasta 4K.
API de generación de vídeo con IA
Texto a vídeo, imagen a vídeo, fotogramas, referencias y sonido.
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-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"])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
API de Flux 2
Prompts largos y ediciones con varias referencias
API de GPT Image 2
Prompts precisos y texto legible
API de Guava
Fotorrealismo que parece una fotografía
API de Mango
Nuestra familia de imágenes insignia
API de Nano Banana 2
Texto nítido y legible, hasta 4K
API de Cherry
Nuestra familia de vídeo insignia
API de Lemon
Todas las funciones de vídeo, a un precio más amable
API de Plum
Sonido en cada clip, hasta 2K
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
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.
Preguntas frecuentes
Preguntas frecuentes
¿Qué es la API de Mage?
¿Qué es el servidor MCP de Mage?
¿Necesito una clave de API para usar el servidor MCP?
¿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.