API Mage · Modèle vidéo
API Plum
Du son sur chaque clip, jusqu'en 2K
POST https://api.mage.space/v1/plum/generateEn un coup d’œil
L'API Plum exécute Plum Fast et 2 autres variantes via Mage à l'adresse POST https://api.mage.space/v1/plum/generate. Une requête avec les réglages par défaut coûte 173 Gems (environ 0,173 $), sans abonnement. Plum accepte les personnages, références et références audio enregistrés via @handle dans le prompt.
- VidéoSortie
- 3Variantes
- 173Gems par clip, par défaut
- $0.173Environ, en USD
Présentation
Ce que fait l'API Plum
Vidéo complète avec audio sur chaque clip et sortie jusqu'en 2K. Images de début et de fin, jusqu'à 9 références ou Characters, et Voices ; de 4 à 15 secondes.
Le modèle vidéo complet de Mage, avec audio généré sur chaque clip et une sortie jusqu'en 2K, décliné en Plum, le plus rapide Plum Max, et Plum Fast, le plus rapide et le moins cher.
Elle accepte first_image, last_image, image, additional_images, videos en entrée.
Démarrage rapide
Appeler l'API Plum
Définis MAGE_API_KEY, envoie ta requête à /plum/generate, puis interroge status_url jusqu'à la fin de la requête.
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"])Modèles
Valeurs de model_id pour Plum
Envoie model_id pour choisir une variante. Sans model_id, la requête utilise la variante par défaut.
| model_id | Nom | Par défaut |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Oui |
Options
Paramètres de Plum
Valeurs autorisées pour l'ensemble des variantes ; une variante peut en proposer moins. La documentation détaille les options de chaque variante.
| Champ | Valeurs |
|---|---|
| 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 |
Entrées
Médias acceptés par Plum
Envoie chacune sous forme d'URL https, d'URL de données ou de fichier importé jusqu'à 100 Mo.
| Champ | Rôle |
|---|---|
| first_image | L'image de la première frame. |
| last_image | L'image de la dernière frame. |
| image | L'image de référence. |
| additional_images | Images de référence supplémentaires. |
| videos | Les vidéos sources. |
Règles
Règles appliquées par l'API Plum
- Les première et dernière images ne peuvent pas être combinées avec des images de référence : envoie l'un ou l'autre.
- Sur `plum-max` et `plum-fast`, une dernière image doit être associée à une première image.
- Le montage vidéo exige exactement une vidéo source de 2 à 15 secondes, une `duration` de sortie et jusqu'à 2 images de référence, personnages et références mentionnés compris. Il n'accepte ni images de début ou de fin, ni références audio, ni voix de personnages : envoie `use_character_voices: false` pour mentionner un personnage qui a une voix.
- Avec `plum-max`, une vidéo source est facturée à un tarif par seconde plus élevé que la sortie, donc en 768P un montage coûte plus cher avec `plum-max` qu'avec `plum`.
Plus de modèles vidéo
Autres API de génération vidéo sur Mage
API Raspberry
Des personnages animés à partir d'une première image
API Seedance
Seedance, avec un filtre strict
API Wan 3.0
Wan 3.0, avec un filtre strict
API Wan Video v2.2
Vidéo open-weights avec une variante Lightning
API Berry
Une vidéo fidèle à tes références
API Blueberry
Fixe la première et la dernière frame
FAQ
Questions fréquentes
Combien coûte l'API Plum ?
Quel est le point de terminaison de l'API Plum ?
Quels modèles Plum puis-je appeler ?
Plum prend-il en charge les images de référence ou les personnages ?
Puis-je utiliser Plum depuis Claude ou ChatGPT ?
Combien de temps les résultats Plum sont-ils conservés ?
Lance-toi avec Mage
Un seul compte, un seul solde de Gems, tous les modèles. Ne paie que ce que tu génères.