Plum API

Auf einen Blick

Die Plum API führt Plum Max und eine weitere Variante über Mage aus, unter POST https://api.mage.space/v1/plum/generate. Eine Anfrage mit den Standardeinstellungen kostet 338 Gems (etwa 0,338 $), ohne Abo. Gespeicherte Characters, References und Audio-Referenzen nimmt Plum per @handle im Prompt entgegen.

• Video

  Ausgabe

• 2

  Varianten

• 338

  Gems pro Clip, Standard

• $0.338

  Ca. in USD

Überblick

Was die Plum API kann

Voll ausgestattetes Video mit Audio in jedem Clip und bis zu 2K-Ausgabe. Start- und Endframes, bis zu 9 Referenzen oder Characters sowie Voices; 4 bis 15 Sekunden.

Das voll ausgestattete Videomodell von Mage mit generiertem Audio in jedem Clip und Ausgabe bis 2K, als Plum und das schnellere Plum Max.

Sie akzeptiert first_image, last_image, image, additional_images, videos als Eingabe.

Schnellstart

Plum API aufrufen

Setze MAGE_API_KEY, sende die Anfrage an /plum/generate und frage status_url ab, bis die Anfrage abgeschlossen ist.

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"])

Modelle

Plum model_id-Werte

Sende model_id, um eine Variante auszuwählen. Ohne Angabe wird die Standardvariante verwendet.

Optionen

Plum-Parameter

Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.

Eingaben

Medieneingaben, die Plum akzeptiert

Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.

Regeln

Was die Plum API erzwingt

• Start- und Endframe lassen sich nicht mit Referenzbildern kombinieren: Sende entweder das eine oder das andere.
• Bei `plum-max` muss ein letzter Frame mit einem ersten Frame kombiniert werden.
• Für die Videobearbeitung brauchst du genau ein Quellvideo von 2 bis 15 Sekunden, eine Ausgabe-`duration` und bis zu 2 Referenzbilder, wobei erwähnte Characters und Referenzen mitgezählt werden. Frames, Audioreferenzen und Character-Stimmen sind nicht möglich: Sende `use_character_voices: false`, um einen Character mit Stimme zu erwähnen.
• Bei `plum-max` wird ein Quellvideo pro Sekunde höher berechnet als die Ausgabe. Daher kostet eine Bearbeitung bei 768P mit `plum-max` mehr als mit `plum`.

Weitere Videomodelle

Weitere APIs zur Videogenerierung auf Mage

FAQ

Häufig gestellte Fragen

Starte jetzt mit Mage

Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.

Ähnliche Inhalte

• API für KI-Videogenerierung
• Plum-API-Referenz
• Plum Playground
• Alle API-Modelle
• Mage MCP-Server