Plum API

In één oogopslag

De Plum API draait Plum Max en 1 andere variant via Mage op POST https://api.mage.space/v1/plum/generate. Een aanvraag met de standaardinstellingen kost 338 Gems (ongeveer $0,338), zonder abonnement. Plum gebruikt opgeslagen personages, referenties en audioreferenties via @handle in de prompt.

• Video

  Uitvoer

• 2

  Varianten

• 338

  Gems per clip (standaard)

• $0.338

  Ongeveer, 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 volledige videomodel van Mage met gegenereerde audio bij elke clip en output tot 2K, als Plum en de snellere Plum Max.

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.

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

Modellen

Plum model_id-waarden

Stuur model_id mee om een variant te kiezen. Zonder model_id wordt de standaardvariant gebruikt.

Opties

Plum-parameters

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

Invoer

Media-input die Plum accepteert

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

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` moet een laatste frame samen met een eerste frame worden gebruikt.
• 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

FAQ

Veelgestelde vragen

Begin met bouwen met Mage

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

Gerelateerd

• API voor AI-video's genereren
• Plum API-referentie
• Plum-playground
• Alle API-modellen
• Mage MCP-server