API di Plum

In breve

L'API di Plum esegue Plum Max e un'altra variante tramite Mage su POST https://api.mage.space/v1/plum/generate. Una richiesta con le impostazioni predefinite costa 338 Gems (circa 0,338 $), senza abbonamento. Plum usa personaggi, riferimenti e riferimenti audio salvati tramite @handle nel prompt.

• Video

  Output

• 2

  Varianti

• 338

  Gems per clip, predefinito

• $0.338

  Circa, in USD

Panoramica

Cosa fa la Plum API

Video con tutte le funzioni, con audio su ogni clip e output fino a 2K. Frame iniziale e finale, fino a 9 riferimenti o Characters, e Voices; da 4 a 15 secondi.

Il modello video completo di Mage, con audio generato su ogni clip e output fino a 2K, disponibile come Plum e come Plum Max, più veloce.

Accetta first_image, last_image, image, additional_images, videos come input.

Guida rapida

Chiama la Plum API

Imposta MAGE_API_KEY, invia la richiesta a /plum/generate e controlla status_url finché la richiesta non è completata.

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

Modelli

Valori di model_id per Plum

Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.

Opzioni

Parametri di Plum

Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.

Input

Input multimediali accettati da Plum

Invia ciascuno come URL https, data URL o upload fino a 100 MB.

Regole

Cosa impone la Plum API

• Primo e ultimo fotogramma non si possono combinare con le immagini di riferimento: invia solo un tipo o l'altro.
• Su `plum-max` un ultimo frame deve essere abbinato a un primo frame.
• La modifica video richiede esattamente un video di origine da 2 a 15 secondi, una `duration` di output e fino a 2 immagini di riferimento, contando i personaggi e i riferimenti menzionati. Non accetta frame, riferimenti audio o voci dei personaggi: invia `use_character_voices: false` per menzionare un personaggio che ha una voce.
• Su `plum-max` il video di origine viene fatturato a una tariffa al secondo più alta rispetto all'output, quindi a 768P una modifica costa di più su `plum-max` che su `plum`.

Altri modelli video

Altre API per generare video su Mage

FAQ

Domande frequenti

Inizia a creare con Mage

Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.

Correlati

• API per la generazione di video con AI
• Riferimento della Plum API
• Playground di Plum
• Tutti i modelli API
• Server MCP di Mage