API de Mage · Generación de video
La API de generación de video con IA, a partir de texto o imágenes
Texto a video, imagen a video, primer y último fotograma y referencias a video con 15 modelos, liderados por Cherry 2 Pro, el modelo estrella de Mage, con audio en muchos clips.
POST https://api.mage.space/v1/{model}/generateDe un vistazo
La API de generación de video de Mage es una API REST en https://api.mage.space/v1 que ejecuta 15 modelos de texto a video e imagen a video, incluidos 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.
- 15modelos de video
- $0.02Opción más barata por defecto, por clip
- 20Generaciones simultáneas
- $0Cuota 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.
| 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, 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) |
| Magejutsu | Cambia el reparto de cualquier video y conserva su movimiento | magejutsu, magejutsu-lite, magejutsu-feather | 1,856 Gems ($1.856) |
| 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, pika-h3-flex, minimax-h3 | 45 Gems ($0.045) |
| Plum | Sonido en cada clip, hasta 2K | plum, plum-max, plum-fast | 173 Gems ($0.173) |
| Raspberry | Personajes que cobran vida desde un primer fotograma | raspberry | 360 Gems ($0.36) |
| Seedance | Seedance, con filtro estricto | seedance-2.0-mini, seedance-2.0-fast, seedance-2.0, seedance-2.5-flash, seedance-2.5 | 618 Gems ($0.618) |
| Wan 3.0 | Wan 3.0, con filtro estricto | wan-3.0 | 245 Gems ($0.245) |
| Wan Video v2.2 | Video de pesos abiertos con una variante Lightning | wan22-video, wan22-video-lightning | 40 Gems ($0.04) |
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.
cURL
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"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('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);Python
# 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.
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.
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.
Casos de uso
Lo que crean los desarrolladores con la API de video
Video corto y para redes sociales
Produce clips verticales para TikTok, Reels y Shorts a partir de un prompt o de la imagen de un producto.
Anima imágenes estáticas
Convierte un primer fotograma, o un primer y último fotograma, en movimiento con modelos de imagen a video como Lemon y Kiwi.
Historias con personajes
Mantén el mismo personaje en todos los planos con modelos de referencia a video que admiten personajes @handle.
Video con sonido
Plum y otros modelos generan voz, efectos de sonido y ambiente junto con la imagen, y admiten referencias de audio para las voces.
Anuncios y demos de producto
Genera muchas variantes de un spot y elige la ganadora, con envíos idempotentes que nunca cobran dos veces.
Edita clips existentes
Berry, Plum y Grok Video editan un video de origen que envíes; Lemon y MiniMax-H3 también admiten videos de referencia.
Preguntas frecuentes
Preguntas frecuentes
¿Cuál es la mejor API de generación de video con IA?
¿La API de video admite imagen a video?
¿Cuánto pueden durar los videos generados?
¿Cuánto tarda en generarse un video?
¿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.