Saltar al contenido

API de Mage · Modelo de video

API de Plum

Sonido en cada clip, hasta 2K

POST https://api.mage.space/v1/plum/generate

De un vistazo

La API de Plum ejecuta Plum Fast y otras 2 variantes a través de Mage en POST https://api.mage.space/v1/plum/generate. Una solicitud con los ajustes por defecto cuesta 173 Gems (unos 0,173 $), sin suscripción. Plum acepta personajes guardados, referencias y referencias de audio mediante @handle en el prompt.

  • VideoResultado
  • 3Variantes
  • 173Gems por clip, predeterminado
  • $0.173Aprox., en USD

Resumen

Qué hace la API de Plum

Video completo con audio en cada clip y resolución de hasta 2K. Fotogramas inicial y final, hasta 9 referencias o Characters, y Voices; de 4 a 15 segundos.

El modelo de vídeo de Mage con todas las funciones, con audio generado en cada clip y salida de hasta 2K, disponible como Plum, el más rápido Plum Max, y Plum Fast, el más veloz y económico.

Acepta first_image, last_image, image, additional_images y videos como entrada.

Inicio rápido

Llama a la API de Plum

Define MAGE_API_KEY, envía la solicitud a /plum/generate y consulta status_url hasta que se complete.

cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/plum/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": "5",
  "model_id": "plum-fast"
}' | 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('plum', {
  prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
  aspect_ratio: '16:9',
  duration: '5',
  model_id: 'plum-fast',
});

console.log(request.result.url);
Python
# pip install mage-space
from mage_space import Mage

mage = Mage()  # reads MAGE_API_KEY

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

print(request["result"]["url"])

Modelos

Valores de model_id de Plum

Envía model_id para elegir una variante. Si no lo incluyes, se usa la predeterminada.

model_idNombrePredeterminado
plumPlum
plum-maxPlum Max
plum-fastPlum FastSí

Opciones

Parámetros de Plum

Valores permitidos en todas las variantes; una variante puede ofrecer menos. La documentación indica las opciones de cada variante.

CampoValores
aspect_ratio16:9, 9:16, 1:1, 4:3, 3:4, 21:9
resolution768P, 2K, 480P
duration4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15

Entradas

Archivos de entrada que acepta Plum

Envía cada una como una URL https, una URL de datos o un archivo subido de hasta 100 MB.

CampoRol
first_imageLa imagen del primer fotograma.
last_imageLa imagen del último fotograma.
imageLa imagen de referencia.
additional_imagesImágenes de referencia adicionales.
videosLos videos de origen.

Reglas

Qué reglas aplica la API de Plum

  • Los fotogramas inicial y final no se pueden combinar con imágenes de referencia: envía un tipo o el otro.
  • En `plum-max` y `plum-fast`, un último fotograma debe ir acompañado de un primer fotograma.
  • La edición de video requiere exactamente un video de origen de 2 a 15 segundos, una `duration` de salida y hasta 2 imágenes de referencia, contando los personajes y las referencias mencionados. No admite fotogramas, referencias de audio ni voces de personajes: envía `use_character_voices: false` para mencionar a un personaje que tenga voz.
  • En `plum-max`, el video de origen se cobra a una tarifa por segundo más alta que el de salida, así que a 768P una edición cuesta más en `plum-max` que en `plum`.

Más modelos de vídeo

Otras API de generación de vídeo en Mage

Preguntas frecuentes

Preguntas frecuentes

¿Cuánto cuesta la API de Plum?
Una solicitud de Plum con los ajustes por defecto (Plum Fast) cuesta 173 Gems, unos 0,173 $. Otras resoluciones, duraciones y variantes cambian el precio; la respuesta indica el cargo exacto. Si una generación falla, se reembolsa; si la bloquea la política de contenido de Mage, no.
¿Cuál es el endpoint de la API de Plum?
POST https://api.mage.space/v1/plum/generate con un encabezado Authorization: Bearer que incluya tu clave de API de Mage. La respuesta incluye una status_url que puedes consultar para obtener el resultado.
¿Qué modelos de Plum puedo llamar?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Por defecto se usa Plum Fast.
¿Plum admite imágenes de referencia o personajes?
Plum acepta first_image, last_image, image, additional_images y videos. Plum usa personajes guardados, referencias y referencias de audio mediante @handle en el prompt.
¿Puedo usar Plum desde Claude o ChatGPT?
Sí. Conecta el servidor MCP de Mage a Claude, ChatGPT, Claude Code, Grok o Cursor y pide Plum por su nombre. Tu asistente consulta sus opciones con get_model y te indica el precio antes de generar.
¿Cuánto tiempo se conservan los resultados de Plum?
Los resultados y las entradas se conservan durante 30 días. Descarga lo que quieras guardar en tu propio almacenamiento.

Empieza a crear con Mage

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

CharactersComunidad