واجهة API وخادم MCP
ولّد من Claude أو Cursor أو من سكربتاتك الخاصة بمفتاح API: النماذج نفسها، والنقاط نفسها، والفشل مُسترَد.
Imaginode خارج لوحة العمل
كل ما تعرف لوحة العمل توليده متاح خارجها أيضًا: واجهة REST وخادم MCP (Model Context Protocol) يتيحان لوكيل ذكاء اصطناعي أو لسكربت إنشاء الصور والفيديوهات بحسابك. تستهلك الاستدعاءات نقاط رصيدك بالأسعار نفسها المعتمدة في لوحة العمل، وأي توليد يفشل تُعاد نقاطه تلقائيًا، كالعادة.
وMCP هو المعيار الذي يتيح لمساعدي الذكاء الاصطناعي (Claude وCursor وغيرهما الكثير) استعمال أدوات خارجية. وبمجرد وصل Imaginode، يستطيع مساعدك أن يولّد صورة في وسط المحادثة، أو أن يرسم مقالًا يكتبه، أو أن ينتج العناصر البصرية لمسار عمل آلي.
إنشاء مفتاح API
اذهب إلى ملفك الشخصي، قسم “مفاتيح API”. أعطِ المفتاح اسمًا (“Claude Code”، “سكربت المدونة”...) وأنشئه: السر imk_… يُعرض مرة واحدة فقط، فانسخه فورًا. خمسة مفاتيح فعّالة كحد أقصى، ويمكن إبطالها في أي لحظة بنقرة واحدة، والمفتاح المُبطَل يتوقف عن العمل فورًا.
يتطلب الإنشاء بريدًا إلكترونيًا موثَّقًا، وكل مفتاح محدود بعشر عمليات توليد في الدقيقة: ما يكفي للعمل براحة، ولا يكفي لإفراغ الرصيد بالخطأ إن انفلت وكيل ما.
وصل خادم 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 يعطي الكتالوج والأسعار بالنقاط. generate_image ينشئ صورة وينتظر النتيجة: يُعاد الرابط مباشرة. generate_video يطلق فيديو ويعيد معرّف متابعة. get_generation_status يتابع عملية توليد حتى الرابط النهائي.
واجهة REST المباشرة
لسكربتاتك، ثلاث نقاط وصول تكفي. GET /api/models يسرد النماذج وخياراتها وأسعارها، دون استيثاق. POST /api/generate يطلق عملية توليد: ملف JSON فيه model وprompt وخيارات النموذج (duration، resolution، aspectRatio، audio، imageUrls)، والمفتاح في ترويسة Authorization، ويحتوي الرد على requestId وcost ورصيدك الجديد. GET /api/generate/status?requestId=… يعيد running، ثم completed مع روابط المخرجات، أو failed مع الاسترداد.
صور الإدخال (imageUrls) يجب أن تكون وسائط مستضافة على حسابك في Imaginode: استوردها أولًا إلى وسائطك، أو أعد استعمال رابط توليد سابق.
ممارسات جيدة
ابدأ بنموذج اقتصادي (Flux Schnell، نقطة واحدة) للتحقق من موجّهاتك قبل الانتقال إلى النماذج المتميزة. أما الفيديو فاستعلم عن حالته كل 30 ثانية: احسب من دقيقة إلى خمس دقائق عادة، وحتى 30 دقيقة في التوليدات الطويلة. والتكلفة الدقيقة تُعاد منذ الإطلاق، قبل النتيجة نفسها.
المفتاح سر: لا تودعه في مستودع ولا تشاركه. وعند أدنى شك، أبطله من ملفك الشخصي وأنشئ مفتاحًا جديدًا.