Mage API · Videomodell
Plum API
Ton in jedem Clip, bis zu 2K
POST https://api.mage.space/v1/plum/generateAuf 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_id | Name | Standard |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Ja |
Optionen
Plum-Parameter
Zulässige Werte über alle Varianten hinweg; eine Variante kann weniger anbieten. Die Optionen pro Variante findest du in der Dokumentation.
| Feld | Werte |
|---|---|
| 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 |
Eingaben
Medieneingaben, die Plum akzeptiert
Sende jede Eingabe als https-URL, als Data-URL oder als Upload mit bis zu 100 MB.
| Feld | Rolle |
|---|---|
| first_image | Das Bild des ersten Frames. |
| last_image | Das Bild für den Endframe. |
| image | Das Referenzbild. |
| additional_images | Weitere Referenzbilder. |
| videos | Die 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
Raspberry API
Characters, die aus einem ersten Frame zum Leben erwachen
Seedance API
Seedance mit strengem Filter
Wan 3.0 API
Wan 3.0 mit strengem Filter
Wan Video v2.2 API
Video mit offenen Gewichten und einer Lightning-Variante
Berry API
Video, das deinen Referenzen treu bleibt
Blueberry-API
Start- und Endframe festlegen
FAQ
Häufig gestellte Fragen
Was kostet die Plum API?
Wie lautet der Endpunkt der Plum API?
Welche Plum-Modelle kann ich aufrufen?
Unterstützt Plum Referenzbilder oder Characters?
Kann ich Plum über Claude oder ChatGPT nutzen?
Wie lange werden Plum-Ergebnisse gespeichert?
Starte jetzt mit Mage
Ein Konto, ein Gems-Guthaben, alle Modelle. Du zahlst nur für das, was du generierst.