API ושרת MCP
ליצור מ-Claude, מ-Cursor או מהסקריפטים שלכם עם מפתח API: אותם מודלים, אותם קרדיטים, והחזר על כישלונות.
Imaginode מחוץ לקנבס
כל מה שהקנבס יודע ליצור זמין גם מחוצה לו: API בסגנון REST ושרת MCP (Model Context Protocol) מאפשרים לסוכן בינה מלאכותית או לסקריפט ליצור תמונות וסרטונים עם החשבון שלכם. הקריאות צורכות קרדיטים מהיתרה שלכם, באותם מחירים כמו בקנבס, ויצירה שנכשלת מזוכה אוטומטית, כרגיל.
MCP הוא התקן שמאפשר לעוזרי בינה מלאכותית (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 יוצר תמונה ומחכה לתוצאה: הכתובת מוחזרת ישירות. generate_video מפעיל סרטון (תמונת פתיחה, תמונת סיום, תמונות רפרנס) ומחזיר מזהה מעקב. generate_speech מקריא טקסט או דיאלוג בקול מהקטלוג או באחד מהקולות המשוכפלים שלכם, generate_sound מפיק אפקט קול או פסקול מוזיקלי, enhance_audio מנקה, מבודד או מפריד קובץ שמע. edit_image מגדיל, גוזר רקע או הופך תמונה לאובייקט תלת מימד; edit_video מגדיל, גוזר רקע, מאריך, מסנכרן שפתיים לקול או מעביר תנועה. list_voices ו-list_characters קוראים את הקולות והדמויות שלכם, get_generation_status עוקב אחר יצירה עד לכתובת הסופית. השרת מדבר את גרסת 2026-07-28 של הפרוטוקול כמו גם את גרסאות ה-handshake של 2025: לקוחות של היום ושל מחר מתחברים אליו בלי שום הגדרה.
ה-API הישיר
לסקריפטים שלכם מספיקות שלוש נקודות קצה. 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 דקות ביצירות ארוכות. העלות המדויקת מוחזרת כבר בהפעלה, עוד לפני התוצאה.
מפתח הוא סוד: אל תבצעו לו commit למאגר ואל תשתפו אותו. בכל ספק קל, בטלו אותו מהפרופיל וצרו אחד חדש.