Mage API · Videomodel
Plum API
Geluid bij elke clip, tot 2K
POST https://api.mage.space/v1/plum/generateIn één oogopslag
De Plum API draait Plum Fast en 2 andere varianten via Mage op POST https://api.mage.space/v1/plum/generate. Een verzoek met de standaardinstellingen kost 173 Gems (ongeveer $0,173), zonder abonnement. Plum gebruikt opgeslagen Characters, References en audioreferenties via @handle in de prompt.
- VideoUitvoer
- 3Varianten
- 173Gems per clip (standaard)
- $0.173Ongeveer, in USD
Overzicht
Wat de Plum API doet
Volledige video met audio bij elke clip en output tot 2K. Begin- en eindframes, tot 9 referenties of Characters, en Voices; 4 tot 15 seconden.
Het videomodel van Mage met alle functies, met gegenereerde audio bij elke clip en uitvoer tot 2K, als Plum, het snellere Plum Max en Plum Fast, het snelste en goedkoopste model.
Accepteert first_image, last_image, image, additional_images en videos als invoer.
Snel starten
Roep de Plum API aan
Stel MAGE_API_KEY in, verstuur naar /plum/generate en poll status_url tot het verzoek klaar is.
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"])Modellen
Plum model_id-waarden
Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.
| model_id | Naam | Standaard |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Ja |
Opties
Plum-parameters
Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.
| Veld | Waarden |
|---|---|
| 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 |
Invoer
Media-input die Plum accepteert
Stuur elk als https-URL, data-URL of upload tot 100 MB.
| Veld | Rol |
|---|---|
| first_image | De afbeelding van het eerste frame. |
| last_image | De afbeelding van het laatste frame. |
| image | De referentieafbeelding. |
| additional_images | Extra referentieafbeeldingen. |
| videos | De bronvideo's. |
Regels
Wat de Plum API afdwingt
- Eerste en laatste frames kunnen niet worden gecombineerd met referentie-afbeeldingen: stuur het een of het ander.
- Bij `plum-max` en `plum-fast` moet een laatste frame worden gekoppeld aan een eerste frame.
- Videobewerking vereist precies één bronvideo van 2 tot 15 seconden, een output-`duration` en maximaal 2 referentiebeelden, waarbij genoemde characters en referenties meetellen. Frames, audioreferenties en character-voices zijn niet mogelijk: stuur `use_character_voices: false` mee om een character met een stem te noemen.
- Bij `plum-max` wordt een bronvideo per seconde tegen een hoger tarief berekend dan de output, dus bij 768P kost een bewerking op `plum-max` meer dan op `plum`.
Meer videomodellen
Andere API's voor videogeneratie op Mage
Raspberry API
Characters tot leven gebracht vanaf een eerste frame
Seedance API
Seedance, met een strikt filter
Wan 3.0 API
Wan 3.0, met een strikt filter
Wan Video v2.2 API
Open-weights video met een Lightning-variant
Berry API
Video die trouw blijft aan je referenties
Blueberry API
Leg het eerste en laatste frame vast
FAQ
Veelgestelde vragen
Wat kost de Plum API?
Wat is het endpoint van de Plum API?
Welke Plum-modellen kan ik aanroepen?
Ondersteunt Plum referentiebeelden of characters?
Kan ik Plum gebruiken vanuit Claude of ChatGPT?
Hoe lang worden Plum-resultaten bewaard?
Begin met bouwen met Mage
Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.