एक नज़र में
Berry API, Mage के ज़रिए POST https://api.mage.space/v1/berry/generate पर Berry 2 और 1 अन्य वेरिएंट चलाता है। डिफ़ॉल्ट सेटिंग पर एक रिक्वेस्ट की कीमत 189 Gems (लगभग $0.189) है, सब्सक्रिप्शन की ज़रूरत नहीं। Berry प्रॉम्प्ट में @handle से सेव किए गए कैरेक्टर और रेफ़रेंस स्वीकार करता है।
वीडियो
आउटपुट
2
वेरिएंट
189
प्रति क्लिप Gems, डिफ़ॉल्ट
$0.189
लगभग, USD में
ओवरव्यू
Berry API क्या करता है
ऐसा वीडियो जो आपके दिए हर रेफ़रेंस के प्रति वफ़ादार रहता है। एक स्टार्ट फ़्रेम, 9 तक रेफ़रेंस या Characters, या एडिट करने के लिए एक सोर्स वीडियो; 1080p तक 3 से 15 सेकंड।
Mage का रेफ़रेंस-आधारित वीडियो मॉडल, जो आपकी दी हुई इमेज के प्रति वफ़ादार रहता है; Berry 2 इसका मौजूदा वर्शन है। पहला फ़्रेम या रेफ़रेंस इमेज, या एडिट करने के लिए एक सोर्स वीडियो।
यह first_image, image, additional_images, video को इनपुट के रूप में स्वीकार करता है।
क्विक स्टार्ट
Berry API कॉल करें
MAGE_API_KEY सेट करें, /berry/generate पर सबमिट करें, और रिक्वेस्ट पूरी होने तक status_url को पोल करें।
cURL
STATUS_URL=$(curl --request POST 'https://api.mage.space/v1/berry/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": "3",
"model_id": "berry-2"
}' | 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('berry', {
prompt: 'A slow push-in on a lighthouse at dusk, waves breaking below',
aspect_ratio: '16:9',
duration: '3',
model_id: 'berry-2',
});
console.log(request.result.url);Python
# pip install mage-space
from mage_space import Mage
mage = Mage() # reads MAGE_API_KEY
request = mage.run("berry", {
"prompt": "A slow push-in on a lighthouse at dusk, waves breaking below",
"aspect_ratio": "16:9",
"duration": "3",
"model_id": "berry-2",
})
print(request["result"]["url"])मॉडल
Berry के model_id मान
वेरिएंट चुनने के लिए model_id भेजें। इसके बिना भेजी गई रिक्वेस्ट डिफ़ॉल्ट वेरिएंट चलाती है।
| model_id | नाम | डिफ़ॉल्ट |
|---|---|---|
| berry | Berry | |
| berry-2 | Berry 2 | हाँ |
विकल्प
Berry के पैरामीटर
सभी वेरिएंट के लिए मान्य मान; किसी वेरिएंट में कम विकल्प हो सकते हैं। डॉक्स में हर वेरिएंट के विकल्प दिए गए हैं।
| फ़ील्ड | मान |
|---|---|
| aspect_ratio | 16:9, 9:16, 1:1, 4:3, 3:4, 4:5, 5:4 |
| resolution | 720p, 1080p, 480p |
| duration | 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 |
इनपुट
Berry जो मीडिया इनपुट स्वीकार करता है
हर इनपुट https URL, data URL या 100 MB तक के अपलोड के रूप में भेजें।
| फ़ील्ड | भूमिका |
|---|---|
| first_image | पहले फ़्रेम की इमेज। |
| image | रेफ़रेंस इमेज। |
| additional_images | अतिरिक्त रेफ़रेंस इमेज। |
| video | सोर्स वीडियो। |
नियम
Berry API क्या लागू करता है
- पहले फ्रेम को रेफ़रेंस इमेज के साथ नहीं जोड़ा जा सकता।
- वीडियो एडिटिंग केवल `berry` पर चलती है, `berry-2` पर नहीं: 3 से 60 सेकंड के सोर्स वीडियो के साथ `model_id: "berry"` भेजें।
और वीडियो मॉडल
Mage पर अन्य वीडियो जनरेशन API
वीडियो · 360 Gems से
Blueberry API
पहला और आखिरी फ्रेम तय करें
वीडियो · 618 Gems से शुरू
Cherry API
हमारी फ़्लैगशिप वीडियो फ़ैमिली
वीडियो · 375 Gems से
Grok Video API
Grok Imagine, मोशन में
वीडियो · 270 Gems से
Kiwi API
रोज़मर्रा के वीडियो, बिना किसी सेटअप के
वीडियो · 245 Gems से शुरू
Lemon API
वीडियो के सारे फ़ीचर, किफ़ायती दाम पर
वीडियो · 20 Gems से
LTX Video API
तेज़ इटरेशन के लिए ओपन-वेट्स वीडियो
अक्सर पूछे जाने वाले सवाल
अक्सर पूछे जाने वाले सवाल
Berry API की कीमत कितनी है?
डिफ़ॉल्ट सेटिंग (Berry 2) पर एक Berry रिक्वेस्ट की कीमत 189 Gems, यानी लगभग $0.189 है। अलग रेज़ोल्यूशन, अवधि और वेरिएंट से कीमत बदलती है; सटीक शुल्क रिस्पॉन्स में दिखता है। जो जनरेशन फ़ेल होता है, उसका रिफ़ंड मिलता है; जिसे Mage की कंटेंट पॉलिसी ब्लॉक करती है, उसका नहीं।
Berry API का एंडपॉइंट क्या है?
POST https://api.mage.space/v1/berry/generate, साथ में आपकी Mage API key वाला Authorization: Bearer हेडर। रिस्पॉन्स में एक status_url होता है, जिसे नतीजे के लिए पोल करें।
मैं कौन-से Berry मॉडल कॉल कर सकता/सकती हूँ?
berry (Berry), berry-2 (Berry 2)। डिफ़ॉल्ट Berry 2 है।
क्या Berry रेफ़रेंस इमेज या कैरेक्टर सपोर्ट करता है?
Berry first_image, image, additional_images, video स्वीकार करता है। Berry सेव किए गए कैरेक्टर और रेफ़रेंस को प्रॉम्प्ट में @handle से लेता है।
क्या मैं Claude या ChatGPT से Berry इस्तेमाल कर सकता/सकती हूँ?
हाँ। Mage MCP सर्वर को Claude, ChatGPT, Claude Code, Grok या Cursor से कनेक्ट करें और नाम लेकर Berry माँगें। आपका असिस्टेंट get_model से इसके विकल्प पढ़ता है और जनरेट करने से पहले कीमत बताता है।
Berry के नतीजे कितने समय तक सेव रहते हैं?
नतीजे और इनपुट 30 दिनों तक रखे जाते हैं। जो भी सहेजना चाहते हैं, उसे अपने स्टोरेज में डाउनलोड कर लें।
Mage के साथ बनाना शुरू करें
एक अकाउंट, एक Gems बैलेंस, हर मॉडल। भुगतान सिर्फ़ उतना, जितना आप जनरेट करें।