Passer au contenu

API Mage · Modèle vidéo

API Plum

Du son sur chaque clip, jusqu'en 2K

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

En 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_idNomPar défaut
plumPlum
plum-maxPlum Max
plum-fastPlum FastOui

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.

ChampValeurs
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

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.

ChampRôle
first_imageL'image de la première frame.
last_imageL'image de la dernière frame.
imageL'image de référence.
additional_imagesImages de référence supplémentaires.
videosLes 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

  • Vidéo · à partir de 360 Gems

    API Raspberry

    Des personnages animés à partir d'une première image

  • Vidéo · à partir de 618 Gems

    API Seedance

    Seedance, avec un filtre strict

  • Vidéo · à partir de 245 Gems

    API Wan 3.0

    Wan 3.0, avec un filtre strict

  • Vidéo · à partir de 40 Gems

    API Wan Video v2.2

    Vidéo open-weights avec une variante Lightning

  • Vidéo · à partir de 189 Gems

    API Berry

    Une vidéo fidèle à tes références

  • Vidéo · à partir de 360 Gems

    API Blueberry

    Fixe la première et la dernière frame

FAQ

Questions fréquentes

Combien coûte l'API Plum ?
Une requête Plum avec les réglages par défaut (Plum Fast) coûte 173 Gems, soit environ 0,173 $. Les autres résolutions, durées et variantes modifient le prix ; la réponse indique le montant exact débité. Une génération qui échoue est remboursée ; une génération bloquée par la politique de contenu de Mage ne l'est pas.
Quel est le point de terminaison de l'API Plum ?
POST https://api.mage.space/v1/plum/generate avec un en-tête Authorization: Bearer contenant ta clé API Mage. La réponse inclut une status_url à interroger pour obtenir le résultat.
Quels modèles Plum puis-je appeler ?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Par défaut, c'est Plum Fast.
Plum prend-il en charge les images de référence ou les personnages ?
Plum accepte first_image, last_image, image, additional_images, videos. Plum prend en charge les personnages enregistrés, les références et les références audio via @handle dans le prompt.
Puis-je utiliser Plum depuis Claude ou ChatGPT ?
Oui. Connecte le serveur MCP de Mage à Claude, ChatGPT, Claude Code, Grok ou Cursor et demande Plum par son nom. Ton assistant lit ses options avec get_model et annonce le prix avant de générer.
Combien de temps les résultats Plum sont-ils conservés ?
Les résultats et les entrées sont conservés pendant 30 jours. Télécharge tout ce que tu veux garder sur ton propre stockage.

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.

CharactersCommunauté