API di Mage · Modello video
API di Plum
Audio in ogni clip, fino a 2K
POST https://api.mage.space/v1/plum/generateIn breve
L'API Plum esegue Plum Fast e altre 2 varianti tramite Mage su POST https://api.mage.space/v1/plum/generate. Una richiesta con le impostazioni predefinite costa 173 Gems (circa 0,173 $), senza abbonamento. Plum accetta personaggi salvati, riferimenti e riferimenti audio tramite @handle nel prompt.
- VideoOutput
- 3Varianti
- 173Gems per clip, predefinito
- $0.173Circa, 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, il più veloce Plum Max e Plum Fast, il più rapido e il più economico.
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.
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"])Modelli
Valori di model_id per Plum
Invia model_id per scegliere una variante. Una richiesta senza model_id usa quella predefinita.
| model_id | Nome | Predefinito |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | |
| plum-fast | Plum Fast | Sì |
Opzioni
Parametri di Plum
Valori consentiti per tutte le varianti; una variante può offrirne meno. La documentazione elenca le opzioni di ogni variante.
| Campo | Valori |
|---|---|
| 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 |
Input
Input multimediali accettati da Plum
Invia ciascuno come URL https, data URL o upload fino a 100 MB.
| Campo | Ruolo |
|---|---|
| first_image | L'immagine del primo frame. |
| last_image | L'immagine dell'ultimo fotogramma. |
| image | L'immagine di riferimento. |
| additional_images | Immagini di riferimento aggiuntive. |
| videos | I video di partenza. |
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.
- Con `plum-max` e `plum-fast` 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
API di Raspberry
Personaggi che prendono vita a partire da un primo fotogramma
API Seedance
Seedance, con un filtro rigoroso
API Wan 3.0
Wan 3.0, con un filtro rigoroso
API Wan Video v2.2
Video open-weights con variante Lightning
API Berry
Video fedeli ai tuoi riferimenti
API di Blueberry
Fissa il primo e l'ultimo fotogramma
FAQ
Domande frequenti
Quanto costa la Plum API?
Qual è l'endpoint della Plum API?
Quali modelli Plum posso chiamare?
Plum supporta immagini di riferimento o personaggi?
Posso usare Plum da Claude o ChatGPT?
Per quanto tempo vengono conservati i risultati di Plum?
Inizia a creare con Mage
Un solo account, un solo saldo di Gems, tutti i modelli. Paghi solo ciò che generi.