डॉक्युमेंटेशन

API और MCP सर्वर

एक API की से Claude, Cursor या अपनी स्क्रिप्ट से जेनरेट कीजिए: वही मॉडल, वही क्रेडिट, और नाकाम जेनरेशन पर रिफ़ंड।

कैनवास के बाहर Imaginode

कैनवास जो कुछ बना सकता है, वह सब उसके बाहर भी उपलब्ध है: एक REST API और एक MCP सर्वर (Model Context Protocol) की मदद से कोई AI एजेंट या स्क्रिप्ट आपके अकाउंट से इमेज और वीडियो बना सकती है। ये कॉल आपके बैलेंस के क्रेडिट खर्च करते हैं, कीमत कैनवास जितनी ही रहती है, और नाकाम जेनरेशन पर हमेशा की तरह अपने आप रिफ़ंड मिल जाता है।

MCP वह स्टैंडर्ड है जिससे AI असिस्टेंट (Claude, Cursor और कई अन्य) बाहरी टूल इस्तेमाल कर पाते हैं। Imaginode जुड़ जाने के बाद आपका असिस्टेंट बातचीत के बीच में ही इमेज बना सकता है, जो लेख वह लिख रहा है उसमें तस्वीर लगा सकता है, या किसी ऑटोमेटेड वर्कफ़्लो के विज़ुअल तैयार कर सकता है।

API की बनाना

अपनी प्रोफ़ाइल पर जाइए, “API कीज़” वाला हिस्सा खोलिए। की को एक नाम दीजिए (“Claude Code”, “ब्लॉग स्क्रिप्ट”...) और बना लीजिए: imk_… वाला सीक्रेट सिर्फ़ एक बार दिखता है, उसे तुरंत कॉपी कर लीजिए। ज़्यादा से ज़्यादा पाँच सक्रिय कीज़ रख सकते हैं, और किसी को भी एक क्लिक में कभी भी रद्द किया जा सकता है; रद्द की गई की उसी पल काम करना बंद कर देती है।

की बनाने के लिए वेरिफ़ाइड ईमेल चाहिए, और हर की पर प्रति मिनट 10 जेनरेशन की सीमा है: आराम से काम करने के लिए काफ़ी, पर इतनी नहीं कि कोई एजेंट बेकाबू हो जाए तो गलती से पूरा बैलेंस खाली कर दे।

MCP सर्वर जोड़ना

सर्वर का पता https://imaginode.ai/api/mcp है (Streamable HTTP ट्रांसपोर्ट)। पहचान के लिए अपनी की “Authorization: Bearer imk_…” हेडर में भेजिए। Claude Code में एक ही कमांड काफ़ी है: claude mcp add --transport http imaginode https://imaginode.ai/api/mcp --header "Authorization: Bearer आपकी-की"। Claude.ai या Cursor में उसी पते और उसी हेडर के साथ एक कस्टम कनेक्टर जोड़ दीजिए।

कुल चौदह टूल्स उपलब्ध हैं। list_models कैटलॉग देता है, हर मॉडल क्या करता है और उसकी क्रेडिट्स में कीमत क्या है; get_balance आपका बैलेंस पढ़ता है, ताकि किसी जनरेशन को शुरू करने से पहले यह जाँचा जा सके कि वह कवर है या नहीं। list_templates और get_template कैनवस के टेम्प्लेट के बारे में बताते हैं: मॉडल, प्रॉम्प्ट, वायरिंग, उदाहरण, और वह लिंक जो उन्हें तुरंत चलाने के लिए तैयार खोलता है। generate_image एक इमेज बनाता है और नतीजे का इंतज़ार करता है: URL सीधे लौटाया जाता है। generate_video एक वीडियो शुरू करता है (स्टार्ट इमेज, एंड इमेज, रेफरेंस इमेज) और एक ट्रैकिंग आईडी लौटाता है। generate_speech किसी टेक्स्ट या डायलॉग को कैटलॉग की किसी आवाज़ या आपकी किसी क्लोन की गई आवाज़ से पढ़ता है, generate_sound साउंड इफेक्ट या म्यूज़िक ट्रैक बनाता है, enhance_audio ऑडियो को साफ करता है, आइसोलेट करता है या अलग-अलग हिस्सों में बाँटता है। edit_image अपस्केल करता है, बैकग्राउंड हटाता है या फोटो को 3D ऑब्जेक्ट में बदलता है; edit_video अपस्केल करता है, बैकग्राउंड हटाता है, आगे बढ़ाता है, आवाज़ के साथ लिप-सिंक करता है या मोशन ट्रांसफर करता है। list_voices और list_characters आपकी आवाज़ें और आपके कैरेक्टर्स पढ़ते हैं, get_generation_status किसी जनरेशन को अंतिम URL तक फॉलो करता है। सर्वर प्रोटोकॉल के 2026-07-28 रिविज़न के साथ-साथ 2025 के हैंडशेक रिविज़न भी बोलता है: आज के और आने वाले कल के क्लाइंट्स किसी सेटिंग के बिना ही जुड़ जाते हैं।

सीधा REST API

आपकी स्क्रिप्ट के लिए तीन एंडपॉइंट काफ़ी हैं। GET /api/models बिना किसी पहचान के मॉडल, उनके विकल्प और कीमतें गिना देता है। POST /api/generate जेनरेशन शुरू करता है: model, prompt और मॉडल के विकल्पों (duration, resolution, aspectRatio, audio, imageUrls) वाला एक JSON, की Authorization हेडर में, और जवाब में requestId, cost और आपका नया बैलेंस आता है। GET /api/generate/status?requestId=… पहले running लौटाता है, फिर आउटपुट URL के साथ completed, या रिफ़ंड के साथ failed।

इनपुट इमेज (imageUrls) आपके Imaginode अकाउंट पर मौजूद मीडिया ही होनी चाहिए: पहले उन्हें अपनी मीडिया लाइब्रेरी में इम्पोर्ट कीजिए, या किसी पिछली जेनरेशन का URL दोबारा इस्तेमाल कर लीजिए।

अच्छी आदतें

प्रीमियम मॉडल पर जाने से पहले किसी सस्ते मॉडल (Flux Schnell, 1 क्रेडिट) से अपने प्रॉम्प्ट परख लीजिए। वीडियो के लिए हर 30 सेकंड पर स्टेटस पूछिए: आम तौर पर 1 से 5 मिनट लगते हैं, लंबी जेनरेशन में 30 मिनट तक। सही लागत रिज़ल्ट आने से भी पहले, शुरू करते ही लौटा दी जाती है।

की एक सीक्रेट है: उसे किसी रिपॉज़िटरी में कमिट मत कीजिए और न ही किसी से साझा कीजिए। ज़रा भी शक हो तो प्रोफ़ाइल से उसे रद्द कीजिए और नई बना लीजिए।

इस गाइड को अमल में लाने के लिए तैयार हैं?

अकाउंट बनाएँ और कैनवास एक्सप्लोर करें: आप उतना ही चुकाते हैं जितना जनरेट करते हैं।

शुरू करें