एक नज़र में
Plum API, Mage के ज़रिए POST https://api.mage.space/v1/plum/generate पर Plum Max और 1 अन्य वैरिएंट चलाता है। डिफ़ॉल्ट सेटिंग पर एक रिक्वेस्ट की कीमत 338 Gems (लगभग $0.338) है, और कोई सब्सक्रिप्शन नहीं है। Plum प्रॉम्प्ट में @handle से सेव किए गए कैरेक्टर, रेफ़रेंस और ऑडियो रेफ़रेंस ले सकता है।
वीडियो
आउटपुट
2
वेरिएंट
338
प्रति क्लिप Gems, डिफ़ॉल्ट
$0.338
लगभग, USD में
ओवरव्यू
Plum API क्या करता है
हर क्लिप में ऑडियो और 2K तक आउटपुट वाला फुल-फीचर वीडियो। स्टार्ट और एंड फ्रेम, 9 तक रेफ़रेंस या 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"])मॉडल
Plum के model_id मान
वेरिएंट चुनने के लिए model_id भेजें। इसके बिना भेजी गई रिक्वेस्ट डिफ़ॉल्ट वेरिएंट चलाती है।
| model_id | नाम | डिफ़ॉल्ट |
|---|---|---|
| plum | Plum | |
| plum-max | Plum Max | हाँ |
विकल्प
Plum पैरामीटर
सभी वेरिएंट के लिए मान्य मान; किसी वेरिएंट में कम विकल्प हो सकते हैं। डॉक्स में हर वेरिएंट के विकल्प दिए गए हैं।
| फ़ील्ड | मान |
|---|---|
| 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 |
इनपुट
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` से ज़्यादा महँगा पड़ता है।
और वीडियो मॉडल
Mage पर अन्य वीडियो जनरेशन API
वीडियो · 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 Max) पर एक Plum रिक्वेस्ट की कीमत 338 Gems, यानी लगभग $0.338 है। दूसरे रेज़ोल्यूशन, अवधि और वेरिएंट से कीमत बदलती है; रिस्पॉन्स में सटीक शुल्क बताया जाता है। जो जनरेशन फ़ेल होता है उसका रिफ़ंड मिलता है; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है उसका नहीं।
Plum API एंडपॉइंट क्या है?
अपनी Mage API key वाले Authorization: Bearer हेडर के साथ POST https://api.mage.space/v1/plum/generate। रिस्पॉन्स में एक status_url आता है, जिसे नतीजे के लिए पोल करें।
मैं कौन-से Plum मॉडल कॉल कर सकता/सकती हूँ?
plum (Plum), plum-max (Plum Max)। डिफ़ॉल्ट Plum Max है।
क्या Plum रेफ़रेंस इमेज या कैरेक्टर सपोर्ट करता है?
Plum first_image, last_image, image, additional_images, videos स्वीकार करता है। सेव किए हुए कैरेक्टर, रेफ़रेंस और ऑडियो रेफ़रेंस प्रॉम्प्ट में @handle से दिए जाते हैं।
क्या मैं Claude या ChatGPT से Plum इस्तेमाल कर सकता/सकती हूँ?
हाँ। Mage MCP सर्वर को Claude, ChatGPT, Claude Code, Grok या Cursor से कनेक्ट करें और Plum का नाम लेकर माँगें। आपका असिस्टेंट get_model से इसके विकल्प पढ़ता है और जनरेट करने से पहले कीमत बताता है।
Plum के नतीजे कितने समय तक रखे जाते हैं?
नतीजे और इनपुट 30 दिनों तक रखे जाते हैं। जो भी सहेजना चाहते हैं, उसे अपने स्टोरेज में डाउनलोड कर लें।
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।