- אימות
- התחברות עם fcaai (OAuth) או מפתח API OAuth 2.1 (PKCE) · Bearer fcaai_live_…
- הרשאה נדרשת
- generations:write
- פרוטוקול
- 2025-11-25 · 2025-06-18 · 2025-03-26 · 2024-11-05
- מחיר
- מחירי API · USD · הרצות שנכשלו מוחזרות
ChatGPT ו-Claude מתחברים דרך התחברות עם חשבון fcaai שלך, בלי מפתח להעתיק. גם כלי קוד יכולים להתחבר כך, או להשתמש במפתח API. מפתחות בדיקה (fcaai_test_) מחויבים כמו מפתחות רגילים. יצירת מפתח
מה זה MCP?
תקן פתוח שמאפשר לעוזרי AI להשתמש בכלים חיצוניים. כשהעוזר לא יכול לבצע משימה בעצמו, הוא קורא לכלי המתאים בשרת מחובר ומחזיר את התוצאה. fcaai מספק את הכלים; רק צריך לדבר.
למה זה טוב?
יצירה מתוך השיחה בלי לעבור בין לשוניות. ההבדל הגדול ביותר מורגש בעבודה חוזרת ורב-שלבית.
- שואל לפני משימות יקרות. השרת מורה לעוזר לציין את המחיר לפני משימות וידאו ו-4K.
- כל מודל, כל הגדרה. אפשרויות כמו יחס תמונה, משך, רזולוציה ואודיו מגיעות מהרשימה של כל מודל.
- ה-Canvas שלך הופך לכלי. לוחות שמפרסמים רצים כזרימה בקריאה אחת.
upload_from_urlurl: …/villa-blue-hour.jpg/u/…estimate_pricemodel: fca/upscale · tier: 2x · source 1920×1080$0.008generatemodel: fca/upscale · image: /u/… · tier: 2xqueuedget_generationwait_seconds: 50succeeded
הגדרה לעוזר שלך
בוחרים אפליקציה. כל מדריך נבדק מול התיעוד הרשמי של אותה אפליקציה. ChatGPT ו-Claude מתחברים עם חשבון fcaai שלך; גם כלי קוד יכולים להתחבר כך, או להשתמש במפתח API.
Claude מתחבר עם חשבון fcaai שלך, בלי מפתח API להעתיק. מחברים מותאמים אישית עובדים במסלולי Free, Pro, Max, Team ו-Enterprise; ב-Free אפשר להוסיף אחד.
פתיחת המחברים
ב-claude.ai או באפליקציית Claude למחשב, יש לעבור אל Customize › Connectors › Add custom connectorהזנת הכתובת
שם fcaai · URL https://api.fcaai.ai/mcpאם החלון שואל איך Claude מזהה את עצמו (OAuth client), יש לבחור Register automaticallyהתחברות עם fcaai
מסך fcaai נפתח. בוחרים חשבון (אישי או צוות), מגדירים מגבלה חודשית ובוחרים Allow. אם אימות דו-שלבי מופעל, יש להזין את הקוד.הפעלה בצ׳אט
בתיבת ההודעה, פותחים את + › Connectors ומפעילים את fcaai. Claude יכול לשאול לפני שכלי רץ: בוחרים Allow once או Always allow.
ב-Team או ב-Enterprise, משתמש Owner מוסיף את fcaai לכולם ב- Organization settings › Connectors › Add › Custom › Web. לאחר מכן כל חבר צוות בוחר Connect ב-Customize › Connectors ומתחבר עם חשבון fcaai משלו.
אחרי החיבור, fcaai עובד גם באפליקציית Claude למובייל, וגם ב-Claude Code כשמתחברים עם אותו חשבון Claude.
https://api.fcaai.ai/mcpfcaai מופיע תחת Your connectors כ-Connected.
להשתמש ב-fcaai: להציג את מודלי התמונה ואת המחירים שלהם.
הצגת מודלים היא בחינם, כך שהבדיקה הזו לא עולה כלום.
צעדים ראשונים
אפשר לדבר עם העוזר כמו שמתדרכים אדם. כדאי להזכיר את fcaai בפעם הראשונה, כדי שיבחר בכלים הנכונים.
דוגמאות לפרומפטים
השתמש ב-fcaai כדי ליצור שתי תמונות 16:9 של וילת זכוכית על רכס אורנים בשעה הכחולה. תגיד לי קודם את המחיר.
עצב מחדש את הסלון שלי בסגנון Japandi עם fcaai ושמור על החלונות ועל הפריסה: https://example.com/room.jpg
צור וידאו של 5 שניות שמתחיל ב-https://example.com/day.jpg ומסתיים ב-https://example.com/night.jpg. תן לי הצעת מחיר לפני שאתה מתחיל.
הגדל את הרינדור האחרון שלי ב-fcaai ל-4K.
הצג לי את הקולות של fcaai, ואז הקרא את הפסקה הזו בקול רגוע וחם.
צור רצועת lo-fi אינסטרומנטלית של 30 שניות לסרטון מוצר.
אילו תבניות של fcaai הופכות תוכנית קומה לרינדור? הרץ את הטובה ביותר על https://example.com/plan.png.
כמה יעלה ב-fcaai וידאו של 10 שניות ב-1080p עם סאונד? אל תריץ אותו.
כמה הוצאתי על fcaai החודש, ועל אילו מודלים? מה היתרה שלי?
איך מעבירים לעוזר תמונה
הכלים של fcaai מקבלים קישורים, לא קבצים מצורפים. כל אחת מהדרכים האלה עובדת:
קישור https ציבורי לקובץ תמונה, וידאו או אודיו (עד 50 MB). העוזר משתמש בו ישירות, או מעתיק אותו קודם ל-fcaai באמצעות upload_from_url
לתוצאות יש קישורים כמו https://fcaai.ai/o/…. אפשר גם פשוט לכתוב “השתמש ברינדור האחרון שלי”, והעוזר ימצא אותו באמצעות list_generations
Claude Code, Codex ו-Gemini CLI יכולים להעלות קובץ מקומי עם ה-CLI של fcaai ולהשתמש בקישור שהוא מדפיס:
npm install -g @fcaai/cli
fcaai login
fcaai upload ./photo.jpg # prints a link to pass to the assistantהקישורים חייבים להיות ציבוריים. כתובות ברשתות פרטיות או דפים שדורשים התחברות נדחים.
היצירות רצות ברקע. העוזר ממתין עם get_generation (עד 50 שניות בכל בדיקה) ובודק שוב עד שהתוצאה מוכנה. אם הצ'אט מסתיים קודם, המשימה עדיין מסתיימת ונשמרת בספרייה שלך. אפשר לשאול אחר כך: “הצג את היצירות האחרונות שלי ב-fcaai”.
לאן התוצאות הולכותכל תוצאה נשמרת בספריית fcaai שלך עם קישור הורדה. עוזרים בטרמינל יכולים גם לשמור את הקובץ ישירות בתיקיית הפרויקט שלך.
חיבורים והוצאות
ההחלטה איזה חשבון אפליקציה משתמשת בו וכמה היא רשאית להוציא היא שלך, ואפשר לשנות אותה בכל עת.
מגבלה חודשית לכל אפליקציה
במסך ההתחברות של fcaai קובעים מגבלה חודשית לאותה אפליקציה ($10, $25 או $100) או ללא מגבלה. כשהיא מושגת, משימות חדשות נעצרות עד החודש הבא (UTC). כדי לשנות אותה, יש להסיר את הגישה ולהתחבר מחדש. key_spend_cap_reached
אישי או צוות
בעלים או מנהלים של צוות יכולים לחבר את האפליקציה לצוות במקום זאת. ההרצות שלה ישולמו אז מיתרת הצוות.
אימות דו-שלבי
אם האפשרות מופעלת, מסך ההתחברות מבקש את קוד המאמת (או קוד גיבוי) לפני מתן הגישה.
הסרת גישה
חשבון › מפתחות API › אפליקציות מחוברות מציג כל אפליקציה שהתחברת אליה, עם החשבון והמגבלה שלה. לאחר הסרת הגישה, האפליקציה מפסיקה לעבוד מיד.
הישארות מחובר
אפליקציות מחדשות את הגישה שלהן בעצמן. אם אפליקציה לא בשימוש במשך 90 יום, או שהוסרה, היא תבקש להתחבר שוב.
מפתחות API לכלי קוד
מומלץ לתת לכל כלי מפתח משלו, רק עם המשימות שהוא צריך ועם תקרת הוצאה חודשית. כך אפשר לבטל מפתח אחד בלי לגעת באחרים.
ניהול מפתחותכלים
אחרי החיבור, העוזר שלך רואה את 53 הכלים האלה. כלי הרשימה, התמחור והמעקב חינמיים; כלים בתשלום מציגים את המחיר לפני שהם מתחילים.
list_modelsמודלים לפי סוג, עם המחיר להגדרות שלךחינםget_modelמודל אחד עם כל האפשרויות שהוא מקבל (ערכים מותרים, טווחים, ברירות מחדל)חינםestimate_priceמחיר מדויק לפני שמשהו רץחינםaccount_balanceיתרה והוצאות המפתח הזה החודשחינםaccount_usageהוצאות לפי יום ומודל לטווח תאריכיםחינםgenerateתמונה, וידאו, אודיו או 3D בכל מודל (אסינכרוני, מחזיר מזהה)בתשלוםgenerate_image1–4 תמונות, עד 4K, עם תמונות תצוגה מקדימהבתשלוםgenerate_speechטקסט לדיבור (MP3) בקול לבחירהבתשלוםgenerate_sfxאפקטים קוליים, עם אורך ולופ רציףבתשלוםgenerate_musicרצועות מוזיקה עם רמה, אורך, סגנון ומיליםבתשלוםgenerate_3dתמונה או פרומפט למודל 3D (GLB); רימש, ריגינג או טקסטורה מחדש למודלי ה-3D שלךבתשלוםlist_voicesקולות למודל דיבור, הקולות המשובטים שלך קודםחינםlist_voice_stylesסגנונות דיבור מוכנים; את ההנחיה מעבירים כ-extra.style_instructionsחינםget_generationסטטוס, פלטים, החזר אם נכשל — עם המתנהחינםlist_generationsהיצירות האחרונות שלך, סינון לפי סטטוסחינםcancel_generationביטול יצירה שעוד לא התחילהחינםupload_from_urlהבאת תמונה או וידאו ציבוריים כקלטחינםupload_fileהבאת קבצים שצורפו בצ'אט (ChatGPT) כקלטיםחינםcreate_upload_linkהעלאת קובץ מהמחשב שלך (Codex, Claude Code) עד 100 MBחינםfcaai_toolsרשימת הכלים העדכנית, כולל כלים שנוספו אחרי שהתחברתחינםfcaai_callהרצת כל כלי קיים, גם כזה שהאפליקציה שלך עוד לא מציגהבתשלוםlist_templatesמתכונים מוכנים והקלטים שהם מקבליםחינםrun_templateהרצת תבנית עם הערכים שלךבתשלוםget_template_runסטטוס הרצת תבנית רב-שלביתחינםdecide_template_planאישור או ניסוח מחדש של תוכנית השוטים בהרצת תבנית סרטחינםcancel_template_runביטול הרצת תבנית רב-שלביתחינםlist_flowsלוחות Canvas שפורסמו כמתכון אחד, עם הקלטים והמחיר שלהםחינםrun_flowהרצת Flow עם הערכים שלך; כל שלב רץ אצלנובתשלוםget_flow_runשלבים ופלטים של הרצת Flowחינםcancel_flow_runביטול הרצת Flowחינםsearch_community_flowsחיפוש זרימות שהקהילה שיתפהחינםcreate_timelineמסטוריבורד לסרט קצר: תצוגות מקדימות, אישור, איכות מלאה, עריכה בחינםבתשלוםget_timelineסטטוס ציר זמן של סצנותחינםpreview_timelineתצוגות מקדימות זולות של סצנות סטוריבורד לפני איכות מלאהבתשלוםapprove_timelineאישור סצנות שנצפו בתצוגה מקדימהחינםfinalize_timelineהפקת הסצנות שאושרו באיכות מלאהבתשלוםexport_timelineחיבור הסצנות ל-MP4 אחד עם קריינות ומוזיקהחינםedit_videoחיתוך וחיבור של הסרטונים שלך, הוספת פסקולחינםlist_style_kitsערכות סגנון ומותג: פלטה, גופנים, כלליםחינםlist_elementsדמויות, מוצרים, מקומות וחומריםחינםread_planמתוכנית קומה לרשימת חדרים עם שטחים כתובים, דלתות וחלונותבתשלוםfinish_panoramaהכנת רינדור 360° לצפייה: 2:1, קצה רציףחינםlist_architecture_projectsהפרויקטים שלך ב-Architecture Studioחינםcreate_architecture_projectיצירת פרויקט אדריכלותחינםadd_to_architecture_projectהוספת תמונה או פלט לפרויקטחינםproduct_list_from_imageרשימת מוצרים מהריהוט והגימורים ברינדורבתשלוםadd_compliance_labelהוספת תווית „תמונה מייצגת” לתמונהחינםlist_compliance_labelsתוויות „תמונה מייצגת” בפרויקטחינםlist_approvalsבקשות אישור של לקוח על לוח והאפשרויות שלהןחינםdecide_approvalאישור אפשרות או בקשת שינויים עם הערהחינםlist_farm_jobsעבודות בחוות רינדור של 3ds Max: התקדמות ועלותחינםpause_farm_jobהשהיית עבודה פעילה בחוות הרינדורחינםresume_farm_jobחידוש עבודה מושהית בחוות הרינדורחינםהגדרות מפתח API
לכלים שמתחברים עם מפתח. מומלץ מפתח נפרד לכל כלי.
הרשאות
מפתח יכול לבצע רק את סוגי המשימות שנבחרו. אם לא נבחר דבר, כל סוגי היצירה מותרים: generations:image · video · audio · 3d · upscale · llm
תקרת הוצאה חודשית
כשמגיעים לתקרה, העוזר נעצר ומקבל את השגיאה הזו. התקרה מתאפסת בתחילת כל חודש קלנדרי (UTC): key_spend_cap_reached
קצב ומקביליות
כברירת מחדל 120 בקשות לדקה ו-2 משימות במקביל. אפשר להוסיף רשימת IP מורשים ותאריך תפוגה.
קלטים בטוחים
כתובות שהעוזר מעביר חייבות להיות קישורי https ציבוריים; רשתות פנימיות וכתובות פרטיות נדחות.
המפתח מוצג פעם אחת בלבד ונשמר רק כגיבוב SHA-256.
פתרון בעיות
קודי שגיאה מופיעים בתוצאת הכלי שהעוזר רואה. הנה משמעותם ומה לעשות.
התבקשת להתחבר שוב401 · invalid_token
הגישה של האפליקציה פגה או הוסרה. יש להתחבר מחדש: ב-Claude לבחור Reconnect במחבר, ב-Claude Code להריץ /mcp, ובכל מקום אחר להסיר את fcaai ולהוסיף אותו שוב.
הגעת למגבלה החודשיתkey_spend_cap_reached
האפליקציה או המפתח ניצלו את המגבלה החודשית. אפשר להעלות את התקרה של המפתח בחשבון › מפתחות API, או להסיר את האפליקציה ולהתחבר שוב עם מגבלה גבוהה יותר.
אין מספיק יתרה402 · insufficient_balance
יש לטעון את היתרה ולבקש מהעוזר לנסות שוב. לא בוצע חיוב.
טעינההמודל לא זמיןmodel_unavailable
המודל עמוס או מושהה. כשקיים מסלול גיבוי, אנחנו עוברים אליו אוטומטית; אחרת אפשר לנסות שוב בעוד רגע או לבקש מודל אחר.
הגדרה נשמטהignored_fields
ההרצה בוצעה, ו-ignored_fields מפרט כל הגדרה שהמודל לא מקבל, עם הסיבה. אפשר לבקש מהעוזר לבדוק ב-get_model מה המודל מקבל.
ערך נדחהinvalid_<field> · invalid_arguments
הערך אינו מותר עבור המודל הזה. השגיאה מפרטת את הערכים המותרים, כך שהעוזר יכול לנסות שוב עם אחד מהם. לא בוצע חיוב.
כלי fcaai לא מופיעים
יש לוודא שהכתובת מסתיימת ב-/mcp. לאחר מכן לרענן: ב-ChatGPT, Refresh בדף Plugins; ב-Claude, להפעיל את fcaai תחת + › Connectors; ב-Cursor, להפעיל אותו ב-Customize; ב-VS Code, Restart Server. עדיין כלום? יש להסיר את fcaai ולהוסיף אותו שוב.
יותר מדי בקשותrate_limited
כברירת מחדל 120 בקשות לדקה לכל חיבור, ולחלק מהכלים יש מגבלה משלהם לדקה. יש להמתין דקה ולנסות שוב.
חסום ברשת של מקום עבודה
אפליקציות במחשב שלך (Claude Code, Codex, Cursor, VS Code…) צריכות גישת HTTPS ל-api.fcaai.ai, וההתחברות פותחת את fcaai.ai בדפדפן. יש לבקש ממחלקת ה-IT לאשר את שניהם.
שאלות
האם השימוש ב-MCP עולה תוספת?
לא. משלמים רק על היצירות שמריצים, לפי מחירי API בדולר אמריקאי. רשימות, הצעות מחיר ובדיקות סטטוס הן בחינם.
האם המסלול הבלתי מוגבל שלי עובד דרך MCP?
לא. ה-API, שרת ה-MCP והתוספים תמיד משתמשים ביתרה שלך. השימוש הבלתי מוגבל חל על Studio, Canvas ותבניות באתר ובאפליקציה.
האם העוזר יכול להתחיל עבודה יקרה בלי לשאול?
ChatGPT ו-Claude יכולים לשאול אותך לפני שכלי רץ, והשרת מורה לעוזר לציין את המחיר לפני עבודות וידאו ו-4K. ההגנה האמיתית שלך היא המגבלה החודשית שנקבעת בזמן החיבור (או תקרת ההוצאה של המפתח): כשמגיעים אליה, שום עבודה חדשה לא מתחילה.
איפה נשמרים הפלטים?
בספריית fcaai שלך, כמו כל מה שיוצרים ב-Studio. העוזר נותן לך את הקישור, ו-Claude Code, Codex וכלי טרמינל אחרים יכולים לשמור את הקובץ ישירות בתיקייה שלך.
התחברות או מפתח API: במה להשתמש?
כשהאפליקציה מציעה התחברות, עדיף להתחבר: אין מפתח להעתיק, בוחרים את החשבון ומגבלה חודשית, ואפשר להסיר את האפליקציה בלחיצה אחת. מפתח API מתאים לסקריפטים, ל-CI ולסביבות שבהן אף אחד לא יכול להתחבר דרך דפדפן.
מי יכול להשתמש בשרת ה-MCP?
כל חשבון fcaai, אישי או צוותי. ההרצות משולמות מהיתרה של אותו חשבון לפי מחירי API, בלי קשר למסלול.
מה קורה אם הרצה נכשלת?
הסכום ששוריין חוזר אוטומטית. אם המסלול הרגיל של מודל נכשל, אנחנו מנסים שוב במסלול גיבוי באותו מחיר.


