Saltar al contenido

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/v1

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 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

  • 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

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.

  1. 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.

  2. 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.

  3. 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 42 Gems

    API de Mango

    Nuestra familia de imágenes insignia

  • Imagen · desde 51 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 173 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

  • 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?
La API de Mage es una API REST en https://api.mage.space/v1 para generar imágenes, video y audio con 37 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 a la API. Antes, la cuenta necesita un primer pago completado, ya sea un paquete de Gems o un plan; los Gems de bonificación por registrarte solo funcionan en la app de Mage.
¿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.

CharactersComunidad