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 מחזיר את הקטלוג ואת המחירים בקרדיטים. generate_image יוצר תמונה וממתין לתוצאה: הכתובת מוחזרת ישירות. generate_video מפעיל סרטון ומחזיר מזהה מעקב. get_generation_status עוקב אחרי יצירה עד לכתובת הסופית.
ה-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 למאגר ואל תשתפו אותו. בכל ספק קל, בטלו אותו מהפרופיל וצרו אחד חדש.