API de Mage · Modelo de video
API de Plum
Sonido en cada clip, hasta 2K
POST https://api.mage.space/v1/plum/generateDe 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_id | Nombre | Predeterminado |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Sí |
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.
| Campo | Valores |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9 |
| resolution | 768P, 2K, 480P |
| duration | 4, 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.
| Campo | Rol |
|---|---|
| first_image | La imagen del primer fotograma. |
| last_image | La imagen del último fotograma. |
| image | La imagen de referencia. |
| additional_images | Imágenes de referencia adicionales. |
| videos | Los 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
API de Raspberry
Personajes que cobran vida desde un primer fotograma
API de Seedance
Seedance, con filtro estricto
API de Wan 3.0
Wan 3.0, con filtro estricto
API de Wan Video v2.2
Vídeo de pesos abiertos con una variante Lightning
API de Berry
Vídeo fiel a tus referencias
API de Blueberry
Fija el primer y el último fotograma
Preguntas frecuentes
Preguntas frecuentes
¿Cuánto cuesta la API de Plum?
¿Cuál es el endpoint de la API de Plum?
¿Qué modelos de Plum puedo llamar?
¿Plum admite imágenes de referencia o personajes?
¿Puedo usar Plum desde Claude o ChatGPT?
¿Cuánto tiempo se conservan los resultados de Plum?
Empieza a crear con Mage
Una cuenta, un saldo de Gems, todos los modelos. Paga solo por lo que generes.