FTIR.funFTIR.fun
אינטגרציה למפתחים ו-AI

חבר FTIR.fun לכל כלי AI או אפליקציה

העניקו לעוזר ה-AI שלכם או לקוד שלכם גישה ישירה ל-320,000+ ספקטרומי ייחוס, להסקת פסגות המבוססת על גרף ידע ולפרשנות הנתמכת בספרות. בחרו אחת משלוש דרכים להתחברות — MCP עבור עוזרי AI, REST API עבור קוד, או Skill מוכן מראש עבור פלטפורמות ללא קוד. כל אחת מהדרכים שלהלן כוללת הוראות שלב־אחר־שלב שנכתבו עבור משתמשים מתחילים.

1. בחר את המסלול שלך 2. הגדרת MCP 3. REST API 4. Skills ותוספים 5. מה ה-AI שלך יכול לעשות 6. פתרון בעיות
מופיע ברשימה ב-

לפני שתתחיל — קבל את מפתח ה-API שלך

MCP ו-REST API משתמשים שניהם במפתח API אחד של FTIR.fun. Coze/Doubao משתמש ב-service key שהוגדר על ידי מפרסם התוסף, כך שמשתמשי הקצה עובדים דרך התוסף בלי להדביק מפתח אישי. השגת מפתח אישי אורכת כדקה:

  1. היכנס ל-FTIR.fun יצירת חשבון בחינם (חשבונות חדשים כוללים קרדיטים לתקופת ניסיון בחינם).
  2. פתח את לוח מפתחות ה-API עבור אל חשבון → מפתחות API ולחץ על Generate.
  3. הצג או העתק את מפתח ה-API שלך המפתח המלא (הוא מתחיל ב-ftir_) נשאר זמין בלוח מקשי ה-API. ניתן לחזור לשם כדי לצפות, להעתיק או לבטל אותו.
🔑 מוכן? פתח את לוח מפתחות ה-API בכרטיסייה חדשה, ואז חזור ופעל לפי הנתיב שבחרת למעלה.

שלב 1 — איזה חיבור מתאים לך?

שלושתם מתחברים לאותו מנוע: 320,000+ ספקטרות, הסקה באמצעות גרף ידע וציטוטים מהספרות. אתה זקוק רק לאחד מהם. בחר בנתיב התואם לאופן העבודה שלך; MCP הוא אפשרות נוחה למשתמשי עוזרי AI.

מה ה-AI שלך יכול לעשות בפועל

שירותי MCP ו-REST המאוחדים חושפים את אותו קטלוג פעולות של FTIR.fun. מפתחות API עשויים לקבל היקף יכולות מצומצם יותר, בעוד שהצהרות ספציפיות לפלטפורמה יכולות לפרסם בכוונה רק תת-קבוצה. הפעולות שלהלן משתמשות באותם שירותי FTIR.fun.

משימה כלי MCP נקודת קצה REST אמור זאת ל-AI שלך
קרא קובץ מכשיר parse_ftir_spectrum POST /parse-spectrum נתח את sample.spc ורשום את הפסגות שזוהו.
המר נתונים בפורמט המקורי ושמור על המטא-נתונים convert_native_spectrum POST /native-spectrum/convert המרת sample.spa ל-JDX ושמירת מטא-דאטה המקור
זהה ספקטרום לא ידוע analyze_ftir_spectrum POST /ftir/analyze_spectrum זהה איזה פולימר הוא הספקטרום הזה.
שלח דוח תלת-צירי מלא submit_ftir_report POST /ftir/reports שלח sample.spa עבור דוח מלא במצב ATR.
בדוק ואחזר את הדוח הזה get_ftir_report_status GET /ftir/reports/{task_id} בדוק את משימת הדוח ותן לי את הקישור כשהיא מסתיימת.
הסבר פסגות explain_peaks POST /ftir/explain_peak_assignments מה מצביעות הפסגות ב-1715 ו-1450 cm-1?
מצא ספקטרום ייחוס ידוע find_spectra POST /ftir/find_spectra מצא ספקטרום ייחוס לפוליסטירן.
פתח מחדש תוצאה קודמת fetch_result GET /ftir/result/{result_num} אחזר תוצאה 20260528100755416137536.
🎓 שיוך פסגות אקדמי — עבור דגימות בעלות הרכב ידוע, יכולת ה-REST/MCP המתקדמת של FTIR.fun מקצה לכל פס שנמדד ראיות המתועדות בספרות. כל שליחה עולה 30 נקודות, או שהיא ללא עלות עם מנוי פעיל; שאילתות סטטוס אינן מחויבות. תאר את המשימה בשפה טבעית (לדוגמה: “שייך את כל פסגות ה-FTIR שנמדדו לספקטרום זה; הדגימה היא PMMA ידוע; שלח לי את הדוח באימייל”) — הלקוח מספק את הקובץ ואתה אף פעם לא צריך לבנות JSON או Base64 בעצמך. תוצאות שהושלמו מחזירות גם את סטטוס ה-JSON וגם כתובות דוח מוגנות; דוחות אינם חשופים בנתיב הורדה ציבורי.

סיומות קבצי ספקטרום נתמכות (36): .spa, .spc, .sp, .abs, .irf, .irs, .dt, .jws, .jdx, .dx, .asc, .dpt, .opju, .opus, .ispd, .[0-9]+, .xlsx, .xls, .ods, .csv, .dat, .txt, .tsv, .json, .tab, .a2r, .asp, .spe, .map, .bsp, .spg, .srs, .smf, .ird, .fsm, .mat. שמור על סיומת הקובץ המקורית. קבצים לא נתמכים או שאינם קריאים מחזירים supported_extensions ו-supported_formats. ערכי sampling_mode תקפים הם KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, ו-Others. Transmission אינו ערך תקף.

דוגמה לתגובת find_spectra

תגובת find_spectra 
{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "instrument_import",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

דוגמה לתגובת explain_peaks

תגובת explain_peaks 
{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

קבלת הדוח המלא (אסינכרוני)

סינון מהיר (analyze_spectrum) מחזיר תוצאה מיד. הדוח המלא בעל שלושת הצירים פועל ברקע ונמשך בדרך כלל 30–90 שניות. שמור את ה-task_id ובצע תשאול שלו במקום לשלוח מחדש.

  1. שלח קרא ל-submit_ftir_report (MCP) או POST /ftir/reports (REST). תקבל בחזרה task_id ו-result_num שמור. שדה file_base64 הוא חובה; שאר השדות (sampling_mode, prior_context, language_code, sample_name, sample_order_no) הם אופציונליים.
    הגש דוגמה (REST) 
    curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'
    תגובה להגשה 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. בדיקה קרא ל-get_ftir_report_status (MCP) או ל-GET /ftir/reports/{task_id} כל 5–10 שניות עד ש-completed הוא true. התשובה שהושלמה כוללת את report_url, אובייקט report (תוכן תוצאה מובנה, עם report_view המפורט בתוכו), ו-result_num.
    דוגמה לבדיקה 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    תגובת בדיקה (בתהליך) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    תגובת בדיקה (הושלמה) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. פתח את הדוח הסופי פתח את ה-URL המלא https://ftir.fun/outputdata/?num={result_num} בדפדפן כדי לצפות בעמוד התוצאה התלת-צירי המלא המוצג על ידי FTIR.fun.
⚠️ יש לשמור את task_id ולבצע סקרים עד להשלמה או לכישלון. שליחות כפולות בזמן שהמשימה בתור או בהרצה מבזבזות נקודות.

פתרון בעיות

מה שרואים מה זה אומר מה לעשות
הלקוח פותח דף הרשאה בדפדפן, או אומר שדף ההרשאה אינו קיים. הלקוח שלך משתמש בהגדרת שרת ישנה בסגנון OAuth. FTIR.fun אינו משתמש ב-OAuth — רק במפתח API. מחק את הגדרת השרת הישנה של ftirfun, הדבק את התצורה המדויקת מעמוד זה, טען מחדש את הלקוח, והתחל את ftirfun שוב.
401 (MCP) / 401 invalid_api_key (REST) מפתח ה-API חסר, פג תוקף, בוטל, או הודבק בצורה שגויה. הפעל מחדש את השרת והדבק רק את המפתח הגולמי (מתחיל ב-ftir_). צור מפתח חדש מתוך דשבורד מפתחות API במידת הצורך
השרת מתחיל אבל לא מופיעים כלים. הלקוח לא רענן את הקטלוג שלו, או שהתצורה משתמשת בשם מפתח שגוי. עבור VS Code, ודא ש-mcp.json משתמש ב-servers (לא ב-mcpServers). לאחר מכן עצור והתחל את ftirfun, או טען מחדש את החלון.
403 insufficient_balance לחשבון אין מספיק נקודות עבור הניתוח הזה. בדוק את היתרה או את המנוי שלך ב-FTIR.fun, ולאחר מכן נסה שוב.
429 rate_limit_exceeded ניתוח ופענוח REST מאפשרים 60 בקשות לדקה לכל מפתח API; קריאות תוצאה וסטטוס דוח ב-REST משתמשות במכסה נפרדת של 120 בקשות לדקה; MCP מאפשר 60 קריאות לדקה עבור כל מפתח API וכלי. המתן לפרק הזמן לניסיון חוזר שדווח על ידי הכלי לפני שתקרא שוב.
דוח נשאר בהמתנה או רץ. דוחות מלאים רצים באופן אסינכרוני ולוקחים יותר זמן מאשר סינון מהיר. שמרו על אותו task_id ובצעו תשאול מחזורי. אם איבדתם את ה-task_id, קראו ל-GET /ftir/tasks כדי להציג את המשימות האחרונות שלכם ולאתר אותו מחדש.
422 או missing_input גוף הבקשה חסר שדות חובה או בעל פורמט לא חוקי. עבור analyze_spectrum, עליך לספק לפחות אחד מ: peaks, query, או file_base64. בדוק שה-JSON שלך תקין, ש-Content-Type הוא application/json, ושהשדות הנדרשים קיימים. ראה את דוגמאות הבקשות למעלה.
413 file_too_large קובץ הספקטרום שהועלה חורג ממגבלת הגודל. ייצא קובץ קטן יותר או השתמש רק במיקומי פסגות דרך שדה spectrum.peaks.

מוכן לבנות?

הפניית ה-REST המלאה כוללת כל endpoint, פורמטים של בקשה ותגובה, אימות, מגבלות קצב, קודי שגיאה, הגדרות כלי MCP, ודוגמאות קוד ב-Python וב-curl.

הגש דרישה טופס