Zum Inhalt springen

Mage API · Videomodell

Plum API

Ton in jedem Clip, bis zu 2K

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

Auf einen Blick

Die Plum API führt Plum Fast und 2 weitere Varianten über Mage unter POST https://api.mage.space/v1/plum/generate aus. Eine Anfrage mit den Standardeinstellungen kostet 173 Gems (ca. 0,173 $), ohne Abo. Plum nutzt gespeicherte Characters, References und Audio-Referenzen, die du im Prompt per @handle angibst.

  • VideoAusgabe
  • 3Varianten
  • 173Gems pro Clip, Standard
  • $0.173Ca. 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 Ton in jedem Clip und Ausgabe bis zu 2K: als Plum, das schnellere Plum Max und Plum Fast, das schnellste und günstigste Modell.

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.

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

Modelle

Plum model_id-Werte

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

model_idNameStandard
plumPlum
plum-maxPlum Max
plum-fastPlum FastJa

Optionen

Plum-Parameter

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

FeldWerte
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

Eingaben

Medieneingaben, die Plum akzeptiert

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

FeldRolle
first_imageDas Bild des ersten Frames.
last_imageDas Bild für den Endframe.
imageDas Referenzbild.
additional_imagesWeitere Referenzbilder.
videosDie Quellvideos.

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` und `plum-fast` 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

  • Video · ab 360 Gems

    Raspberry API

    Characters, die aus einem ersten Frame zum Leben erwachen

  • Video · ab 618 Gems

    Seedance API

    Seedance mit strengem Filter

  • Video · ab 245 Gems

    Wan 3.0 API

    Wan 3.0 mit strengem Filter

  • Video · ab 40 Gems

    Wan Video v2.2 API

    Video mit offenen Gewichten und einer Lightning-Variante

  • Video · ab 189 Gems

    Berry API

    Video, das deinen Referenzen treu bleibt

  • Video · ab 360 Gems

    Blueberry-API

    Start- und Endframe festlegen

FAQ

Häufig gestellte Fragen

Was kostet die Plum API?
Eine Plum-Anfrage mit den Standardeinstellungen (Plum Fast) kostet 173 Gems, etwa 0,173 $. Andere Auflösungen, Längen und Varianten verändern den Preis; die Antwort enthält den genauen Betrag. Bei einer fehlgeschlagenen Generierung erhältst du eine Rückerstattung, bei einer von der Inhaltsrichtlinie von Mage blockierten nicht.
Wie lautet der Endpunkt der Plum API?
POST https://api.mage.space/v1/plum/generate mit einem Authorization: Bearer-Header, der deinen Mage-API-Schlüssel enthält. Die Antwort enthält eine status_url, die du für das Ergebnis abfragen kannst.
Welche Plum-Modelle kann ich aufrufen?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). Standard ist Plum Fast.
Unterstützt Plum Referenzbilder oder Characters?
Plum akzeptiert first_image, last_image, image, additional_images, videos. Gespeicherte Characters, Referenzen und Audioreferenzen übernimmt Plum per @handle im Prompt.
Kann ich Plum über Claude oder ChatGPT nutzen?
Ja. Verbinde den Mage-MCP-Server mit Claude, ChatGPT, Claude Code, Grok oder Cursor und frag direkt nach Plum. Dein Assistent liest die Optionen mit get_model aus und nennt dir den Preis, bevor er generiert.
Wie lange werden Plum-Ergebnisse gespeichert?
Ergebnisse und Eingaben werden 30 Tage lang gespeichert. Lade alles, was du behalten möchtest, in deinen eigenen Speicher herunter.

Starte jetzt mit Mage

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

CharactersCommunity