La API de generación de video con IA, a partir de texto o imágenes

De un vistazo

La API de generación de video de Mage es una API REST en https://api.mage.space/v1 que ejecuta 12 modelos de texto a video e imagen a video, entre ellos Cherry 2 Pro, Lemon, Plum, Melon, MiniMax-H3, Grok Video y Wan. Envía un prompt y, si quieres, fotogramas o referencias, consulta el estado de la solicitud y descarga un MP4. Cada clip se paga en Gems según el modelo, la resolución y la duración.

• 12

  modelos de video

• $0.02

  Opción más barata por defecto, por clip

• 20

  Generaciones simultáneas

• $0

  Cuota mensual

Modelos

Todos los modelos de video 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.

Inicio rápido

Genera un video con Berry 2

Define MAGE_API_KEY, envía la solicitud y consulta el estado hasta que termine. Cambia berry en la URL por cualquiera de los modelos de arriba.

STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/generate' \
  --header "Authorization: Bearer $MAGE_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{
  "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
  "aspect_ratio": "16:9",
  "duration": "3",
  "model_id": "berry-2"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// npm install @mage-space/sdk
import Mage from '@mage-space/sdk';

const mage = new Mage(); // reads MAGE_API_KEY

const request = await mage.run('berry', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '3',
  model_id: 'berry-2',
});

console.log(request.result.url);

# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

request = mage.run("berry", {
    "prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
    "aspect_ratio": "16:9",
    "duration": "3",
    "model_id": "berry-2",
})

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

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

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

   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

Casos de uso

Lo que crean los desarrolladores con la API de video

Preguntas frecuentes

Preguntas frecuentes

Empieza a crear con Mage

Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.

Relacionado

• API de generación de imágenes con IA
• API de generación de audio con IA
• Servidor MCP de Mage
• SDK de Mage
• Mage para ComfyUI
• Todos los modelos de la API
• Playground de la API
• Documentación de la API