API Plum

En un coup d’œil

L'API Plum exécute Plum Max et une autre variante via Mage sur POST https://api.mage.space/v1/plum/generate. Une requête avec les réglages par défaut coûte 338 Gems (environ 0,338 $), sans abonnement. Plum utilise les personnages, références et références audio enregistrés via @handle dans le prompt.

• Vidéo

  Sortie

• 2

  Variantes

• 338

  Gems par clip, par défaut

• $0.338

  Environ, 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 sortie jusqu'en 2K, proposé en Plum et en Plum Max, plus rapide.

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.

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-max"
}' | jq -r '.status_url')

# Repeat until status is "completed"; result.url is the file
curl "$STATUS_URL" --header "Authorization: Bearer $MAGE_API_KEY"

// 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-max',
});

console.log(request.result.url);

# 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-max",
})

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.

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.

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.

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.
• Avec `plum-max`, 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

FAQ

Questions fréquentes

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.

À voir aussi

• API de génération de vidéos IA
• Référence de l'API Plum
• Playground Plum
• Tous les modèles de l'API
• Serveur MCP Mage