واجهة 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 الكتالوغ، ووظيفة كل نموذج وسعره بالأرصدة؛ وتقرأ get_balance رصيدكم، للتحقق من أن التوليد مغطى قبل تشغيله. تصف list_templates وget_template قوالب اللوحة: النماذج، التعليمات، التوصيل، الأمثلة، والرابط الذي يفتحها جاهزة للتشغيل. تنشئ generate_image صورة وتنتظر النتيجة: يُعاد الرابط مباشرة. تُشغّل generate_video فيديو (صورة بداية، صورة نهاية، صور مرجعية) وتعيد معرّف تتبع. تقرأ generate_speech نصًا أو حوارًا بصوت من الكتالوغ أو بأحد أصواتكم المستنسخة، وتُنتج generate_sound مؤثرًا صوتيًا أو مقطوعة موسيقية، وتنظّف enhance_audio ملفًا صوتيًا أو تعزله أو تفصله. تكبّر edit_image الصورة أو تفرّغ خلفيتها أو تحوّلها إلى جسم ثلاثي الأبعاد؛ وتكبّر edit_video الفيديو أو تفرّغ خلفيته أو تمدّده أو تزامن شفتيه مع صوت أو تنقل حركة إليه. تقرأ list_voices وlist_characters أصواتكم وشخصياتكم، وتتابع get_generation_status توليدًا حتى الرابط النهائي. يتحدث الخادم مراجعة البروتوكول 2026-07-28 كما يتحدث مراجعات المصافحة لعام 2025: يتصل به عملاء اليوم وعملاء الغد دون أي إعداد.
واجهة 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 دقيقة في التوليدات الطويلة. والتكلفة الدقيقة تُعاد منذ الإطلاق، قبل النتيجة نفسها.
المفتاح سر: لا تودعه في مستودع ولا تشاركه. وعند أدنى شك، أبطله من ملفك الشخصي وأنشئ مفتاحًا جديدًا.