FTIR.funFTIR.fun
डेव्हलपर आणि AI इंटिग्रेशन

FTIR.fun कोणत्याही AI टूल किंवा अॅपशी कनेक्ट करा

तुमच्या AI सहाय्यकाला किंवा तुमच्या स्वतःच्या कोडला 320,000+ संदर्भ स्पेक्ट्रम, नॉलेज-ग्राफ पीक रिझनिंग आणि साहित्याधारित अर्थनिर्णयाचा थेट प्रवेश द्या. जोडणीसाठी तीनपैकी एक मार्ग निवडा — AI सहाय्यकांसाठी MCP, कोडसाठी REST API किंवा नो-कोड प्लॅटफॉर्मसाठी तयार Skill. खालील प्रत्येक मार्गामध्ये प्रथमच वापरणाऱ्या वापरकर्त्यांसाठी चरण-दर-चरण सूचना दिल्या आहेत.

१. तुमचा मार्ग निवडा 2. MCP सेटअप 3. REST API 4. कौशल्ये आणि प्लगइन ५. तुमचे AI काय करू शकते 6. समस्या निवारण
यादीत समाविष्ट केलेले

सुरू करण्यापूर्वी — तुमची API की मिळवा

MCP आणि REST API दोन्ही एकच FTIR.fun API key वापरतात. Coze/Doubao सेवा-की वापरते, जी प्लगइन प्रकाशकाद्वारे कॉन्फिगर केली जाते; त्यामुळे अंतिम वापरकर्ते वैयक्तिक की पेस्ट न करता प्लगइनद्वारे काम करतात. वैयक्तिक की मिळवण्यासाठी साधारण एक मिनिट लागतो:

  1. FTIR.fun मध्ये साइन इन करा विनामूल्य खाते तयार करा (नवीन खात्यांमध्ये विनामूल्य चाचणी क्रेडिट्स समाविष्ट आहेत).
  2. API Keys डॅशबोर्ड उघडा येथे जा खाते → API Keys आणि Generate वर क्लिक करा.
  3. तुमची API की पहा किंवा कॉपी करा पूर्ण की (ती ftir_ ने सुरू होते) API कीज डॅशबोर्डमध्ये उपलब्ध आहे. तुम्ही ती पाहण्यासाठी, कॉपी करण्यासाठी किंवा रद्द करण्यासाठी तेथे परत जाऊ शकता.
🔑 तयार आहात? API Keys डॅशबोर्ड उघडा नवीन टॅबमध्ये, नंतर परत या आणि वर निवडलेला मार्ग अनुसरण करा.

पायरी 1 — तुमच्यासाठी कोणते कनेक्शन योग्य आहे?

तिन्ही एकाच इंजिनशी जोडलेले आहेत: 320,000+ स्पेक्ट्रा, नॉलेज-ग्राफ रिझनिंग आणि साहित्यिक संदर्भ. तुम्हाला फक्त एकाची गरज आहे. तुम्ही ज्या पद्धतीने काम करता त्याला अनुरूप मार्ग निवडा; AI असिस्टंट वापरकर्त्यांसाठी MCP हा सोयीस्कर पर्याय आहे.

तुमचा AI प्रत्यक्षात काय करू शकतो

युनिफाइड MCP आणि REST सेवा समान FTIR.fun ऑपरेशन कॅटलॉग उपलब्ध करून देतात. API कीजना कमी क्षमतेची व्याप्ती मिळू शकते, तर प्लॅटफॉर्म-विशिष्ट घोषणांद्वारे जाणीवपूर्वक केवळ काही उपसंच प्रकाशित केला जाऊ शकतो. खालील ऑपरेशन्स समान FTIR.fun सेवा सामायिक करतात.

कार्य MCP साधन REST endpoint तुमच्या 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 ATR मोडमध्ये पूर्ण अहवालासाठी sample.spa सबमिट करा.
पोल करा आणि तो अहवाल मिळवा. 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 आणा.
🎓 शैक्षणिक शिखर नियुक्ती — ज्ञात संरचना असलेल्या नमुन्यांसाठी, प्रगत FTIR.fun REST/MCP क्षमता साहित्यिक संदर्भांद्वारे मागोवा घेता येणाऱ्या पुराव्यांसह प्रत्येक मोजलेल्या शिखराचे निर्धारण करते. प्रत्येक सबमिशनसाठी 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) त्वरित परतावा देते. संपूर्ण त्रि-अक्षीय अहवाल पार्श्वभूमीत चालतो आणि सामान्यतः ३०–९० सेकंद लागतात. 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. अंतिम अहवाल उघडा FTIR.fun द्वारे प्रस्तुत केलेले संपूर्ण ट्राय-अक्ष परिणाम पृष्ठ पाहण्यासाठी ब्राउझरमध्ये पूर्ण URL https://ftir.fun/outputdata/?num={result_num} उघडा.
⚠️ task_id जतन करा आणि प्रक्रिया पूर्ण होईपर्यंत किंवा अयशस्वी होईपर्यंत poll करा. रांगेत असताना किंवा प्रक्रिया सुरू असताना केलेले दुहेरी सबमिशन पॉइंट्स वाया घालवतात.

समस्या निवारण

तुम्हाला काय दिसते याचा अर्थ काय काय करावे
क्लायंट ब्राउझर ऑथोरायझेशन पेज उघडतो, किंवा ऑथोरायझेशन पेज अस्तित्वात नाही असे सांगतो. तुमचा क्लायंट जुनी 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 विश्लेषण आणि पार्सिंग प्रति API की 60 विनंत्या प्रति मिनिट परवानगी देतात; REST परिणाम आणि रिपोर्ट-स्थिती वाचन वेगळ्या 120 विनंत्या प्रति मिनिट बकेटचा वापर करतात; MCP प्रति API की आणि साधन 60 कॉल प्रति मिनिट परवानगी देते. पुन्हा कॉल करण्यापूर्वी साधनाने कळवलेल्या पुनर्प्रयत्न कालावधीची प्रतीक्षा करा.
अहवाल रांगेत किंवा चालू राहतो. पूर्ण अहवाल असिंक्रोनसपणे चालतात आणि द्रुत स्क्रीनिंगपेक्षा जास्त वेळ घेतात. तोच 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 संदर्भात प्रत्येक एंडपॉइंट, विनंती आणि प्रतिसाद स्वरूप, प्रमाणीकरण, दर मर्यादा, त्रुटी कोड, MCP साधन व्याख्या आणि Python आणि curl मध्ये कोड उदाहरणे आहेत.

आवश्यकता सबमिट करा फॉर्म