Ga naar de inhoud

Mage API · Videomodel

Plum API

Geluid bij elke clip, tot 2K

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

In éé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_idNaamStandaard
plumPlum
plum-maxPlum Max
plum-fastPlum FastJa

Opties

Plum-parameters

Toegestane waarden voor alle varianten; een variant kan minder opties bieden. In de documentatie staan de opties per variant.

VeldWaarden
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

Invoer

Media-input die Plum accepteert

Stuur elk als https-URL, data-URL of upload tot 100 MB.

VeldRol
first_imageDe afbeelding van het eerste frame.
last_imageDe afbeelding van het laatste frame.
imageDe referentieafbeelding.
additional_imagesExtra referentieafbeeldingen.
videosDe 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

  • Video · vanaf 360 Gems

    Raspberry API

    Characters tot leven gebracht vanaf een eerste frame

  • Video · vanaf 618 Gems

    Seedance API

    Seedance, met een strikt filter

  • Video · vanaf 245 Gems

    Wan 3.0 API

    Wan 3.0, met een strikt filter

  • Video · vanaf 40 Gems

    Wan Video v2.2 API

    Open-weights video met een Lightning-variant

  • Video · vanaf 189 Gems

    Berry API

    Video die trouw blijft aan je referenties

  • Video · vanaf 360 Gems

    Blueberry API

    Leg het eerste en laatste frame vast

FAQ

Veelgestelde vragen

Wat kost de Plum API?
Een Plum-verzoek met de standaardinstellingen (Plum Fast) kost 173 Gems, ongeveer $0,173. Andere resoluties, duur en varianten veranderen de prijs; het antwoord toont de exacte kosten. Een mislukte generatie wordt terugbetaald; een generatie die door het contentbeleid van Mage wordt geblokkeerd niet.
Wat is het endpoint van de Plum API?
POST https://api.mage.space/v1/plum/generate met een Authorization: Bearer-header met je Mage API-sleutel. Het antwoord bevat een status_url om te pollen voor het resultaat.
Welke Plum-modellen kan ik aanroepen?
plum (Plum), plum-max (Plum Max), plum-fast (Plum Fast). De standaard is Plum Fast.
Ondersteunt Plum referentiebeelden of characters?
Plum accepteert first_image, last_image, image, additional_images, videos. Plum gebruikt opgeslagen characters, referenties en audioreferenties via @handle in de prompt.
Kan ik Plum gebruiken vanuit Claude of ChatGPT?
Ja. Verbind de Mage MCP-server met Claude, ChatGPT, Claude Code, Grok of Cursor en vraag op naam naar Plum. Je assistent leest de opties uit met get_model en noemt de prijs voordat hij genereert.
Hoe lang worden Plum-resultaten bewaard?
Resultaten en invoer worden 30 dagen bewaard. Download alles wat je wilt houden naar je eigen opslag.

Begin met bouwen met Mage

Eén account, één Gems-saldo, alle modellen. Je betaalt alleen voor wat je genereert.

CharactersCommunity