Μετάβαση στο περιεχόμενο
PlaygroundΤεκμηρίωσηΑπόκτησε κλειδί API

Mage API · Μοντέλο βίντεο

Plum API

Ήχος σε κάθε κλιπ, έως 2K

Απόκτησε κλειδί APIΔοκίμασε το Plum στο playground
POST https://api.mage.space/v1/plum/generate

Με μια ματιά

Το Plum API τρέχει το Plum Max και μία ακόμη παραλλαγή μέσω του Mage στο POST https://api.mage.space/v1/plum/generate. Ένα αίτημα με τις προεπιλεγμένες ρυθμίσεις κοστίζει 338 Gems (περίπου $0.338), χωρίς συνδρομή. Το Plum δέχεται αποθηκευμένους χαρακτήρες, αναφορές και ηχητικές αναφορές με @handle στο prompt.

  • ΒίντεοΈξοδος
  • 2Παραλλαγές
  • 338Gems ανά κλιπ, προεπιλογή
  • $0.338Περίπου, σε USD

Επισκόπηση

Τι κάνει το Plum API

Βίντεο με όλες τις δυνατότητες, με ήχο σε κάθε κλιπ και έξοδο έως 2K. Αρχικό και τελικό καρέ, έως 9 References ή Characters και Voices· 4 έως 15 δευτερόλεπτα.

Το μοντέλο βίντεο του Mage με όλες τις δυνατότητες, με παραγόμενο ήχο σε κάθε κλιπ και έξοδο έως 2K, ως Plum και το ταχύτερο Plum Max.

Δέχεται ως εισόδους τα first_image, last_image, image, additional_images, videos.

Γρήγορη εκκίνηση

Κάλεσε το Plum API

Όρισε το MAGE_API_KEY, υπέβαλε το αίτημα στο /plum/generate και έλεγχε το status_url μέχρι να ολοκληρωθεί το αίτημα.

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-max"
}' | 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-max',
});

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-max",
})

print(request["result"]["url"])

Μοντέλα

Τιμές model_id του Plum

Στείλε το model_id για να διαλέξεις παραλλαγή. Ένα αίτημα χωρίς αυτό εκτελεί την προεπιλεγμένη.

model_idΌνομαΠροεπιλογή
plumPlum
plum-maxPlum MaxΝαι

Επιλογές

Παράμετροι του Plum

Οι τιμές που επιτρέπονται σε όλες τις παραλλαγές· μια παραλλαγή μπορεί να προσφέρει λιγότερες. Τα docs αναφέρουν τις επιλογές ανά παραλλαγή.

ΠεδίοΤιμές
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

Είσοδοι

Είσοδοι πολυμέσων που δέχεται το Plum

Στείλε κάθε αρχείο ως https URL, ως data URL ή ως ανέβασμα έως 100 MB.

ΠεδίοΡόλος
first_imageΗ εικόνα του πρώτου καρέ.
last_imageΗ εικόνα του τελευταίου καρέ.
imageΗ εικόνα αναφοράς.
additional_imagesΠρόσθετες εικόνες αναφοράς.
videosΤα βίντεο-πηγή.

Κανόνες

Τι επιβάλλει το Plum API

  • Το πρώτο και το τελευταίο καρέ δεν συνδυάζονται με εικόνες αναφοράς: στείλε το ένα ή το άλλο.
  • Στο `plum-max` το τελευταίο καρέ πρέπει να συνοδεύεται από πρώτο καρέ.
  • Η επεξεργασία βίντεο δέχεται ακριβώς ένα βίντεο-πηγή 2 έως 15 δευτερολέπτων, ένα `duration` εξόδου και έως 2 εικόνες αναφοράς, μετρώντας τους χαρακτήρες και τις αναφορές που αναφέρονται. Δεν δέχεται καρέ, ηχητικές αναφορές ή φωνές χαρακτήρων: στείλε `use_character_voices: false` για να αναφέρεις έναν χαρακτήρα που έχει φωνή.
  • Στο `plum-max`, το βίντεο-πηγή χρεώνεται με υψηλότερη τιμή ανά δευτερόλεπτο από το βίντεο εξόδου, οπότε στα 768P μια επεξεργασία κοστίζει περισσότερο στο `plum-max` απ' ό,τι στο `plum`.

Περισσότερα μοντέλα βίντεο

Άλλα API δημιουργίας βίντεο στο Mage

  • Βίντεο · από 360 Gems

    Raspberry API

    Χαρακτήρες που ζωντανεύουν από ένα πρώτο καρέ

  • Βίντεο · από 40 Gems

    Wan Video v2.2 API

    Βίντεο ανοιχτών βαρών με παραλλαγή Lightning

  • Βίντεο · από 189 Gems

    Berry API

    Βίντεο που μένει πιστό στις αναφορές σου

  • Βίντεο · από 360 Gems

    Blueberry API

    Καθόρισε το πρώτο και το τελευταίο καρέ

  • Βίντεο · από 618 Gems

    Cherry API

    Η κορυφαία οικογένεια μοντέλων βίντεο μας

  • Βίντεο · από 375 Gems

    Grok Video API

    Το Grok Imagine σε κίνηση

Συχνές ερωτήσεις

Συχνές ερωτήσεις

Πόσο κοστίζει το Plum API;
Ένα αίτημα Plum με τις προεπιλεγμένες ρυθμίσεις (Plum Max) κοστίζει 338 Gems, περίπου $0.338. Άλλες αναλύσεις, διάρκειες και παραλλαγές αλλάζουν την τιμή· η απάντηση δείχνει την ακριβή χρέωση. Αν μια δημιουργία αποτύχει, γίνεται επιστροφή· αν τη μπλοκάρει η πολιτική περιεχομένου του Mage, δεν γίνεται.
Ποιο είναι το endpoint του Plum API;
POST https://api.mage.space/v1/plum/generate με κεφαλίδα Authorization: Bearer που περιέχει το κλειδί API του Mage. Η απάντηση περιλαμβάνει ένα status_url για να ελέγχεις το αποτέλεσμα.
Ποια μοντέλα Plum μπορώ να καλέσω;
plum (Plum), plum-max (Plum Max). Η προεπιλογή είναι το Plum Max.
Υποστηρίζει το Plum εικόνες αναφοράς ή χαρακτήρες;
Το Plum δέχεται first_image, last_image, image, additional_images, videos. Το Plum δέχεται αποθηκευμένους χαρακτήρες, αναφορές και ηχητικές αναφορές με @handle στο prompt.
Μπορώ να χρησιμοποιήσω το Plum από το Claude ή το ChatGPT;
Ναι. Σύνδεσε τον διακομιστή Mage MCP με Claude, ChatGPT, Claude Code, Grok ή Cursor και ζήτα το Plum με το όνομά του. Ο βοηθός σου διαβάζει τις επιλογές του με το get_model και αναφέρει την τιμή πριν δημιουργήσει.
Για πόσο διατηρούνται τα αποτελέσματα του Plum;
Τα αποτελέσματα και οι είσοδοι διατηρούνται για 30 ημέρες. Κατέβασε στον δικό σου χώρο αποθήκευσης ό,τι θέλεις να κρατήσεις.

Ξεκίνα να δημιουργείς με το Mage

Ένας λογαριασμός, ένα υπόλοιπο Gems, όλα τα μοντέλα. Πληρώνεις μόνο για ό,τι δημιουργείς.

Απόκτησε κλειδί APIΔοκίμασε το Plum στο playground