FTIR.funFTIR.fun
डेवलपर और AI एकीकरण

FTIR.fun को किसी भी AI टूल या ऐप से कनेक्ट करें

अपने AI सहायक या अपने कोड को 320,000+ संदर्भ स्पेक्ट्रा, नॉलेज-ग्राफ पीक रीजनिंग और साहित्य-समर्थित व्याख्या तक सीधी पहुँच दें। कनेक्ट करने के तीन तरीकों में से एक चुनें — AI सहायकों के लिए MCP, कोड के लिए REST API, या नो-कोड प्लेटफ़ॉर्म के लिए तैयार Skill। नीचे दिए गए प्रत्येक मार्ग में पहली बार उपयोग करने वालों के लिए चरण-दर-चरण निर्देश दिए गए हैं।

1. अपना पथ चुनें 2. MCP सेटअप 3. REST API 4. कौशल और प्लगइन्स 5. आपका AI क्या कर सकता है 6. समस्या निवारण
इस तारीख को सूचीबद्ध

शुरू करने से पहले — अपनी API कुंजी प्राप्त करें

MCP और REST API दोनों एक ही FTIR.fun API key का उपयोग करते हैं। Coze/Doubao उस service key का उपयोग करता है जिसे प्लगइन प्रकाशक द्वारा कॉन्फ़िगर किया गया है, इसलिए अंतिम उपयोगकर्ता व्यक्तिगत key डाले बिना प्लगइन के माध्यम से काम करते हैं। व्यक्तिगत key प्राप्त करने में लगभग एक मिनट लगता है:

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

चरण 1 — आपके लिए कौन सा कनेक्शन सही है?

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

आपका 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 Convert sample.spa to JDX and keep the source metadata.
अज्ञात स्पेक्ट्रम की पहचान करें 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) तुरंत परिणाम लौटाती है। पूर्ण त्रि-अक्षीय रिपोर्ट पृष्ठभूमि में चलती है और सामान्यतः 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. मतदान हर 5–10 सेकंड में get_ftir_report_status (MCP) या GET /ftir/reports/{task_id} को कॉल करें जब तक कि 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 को बनाए रखें और पूर्ण या विफल होने तक पोल करते रहें। कतार में या चल रहे कार्यों के दौरान डुप्लिकेट सबमिशन पॉइंट्स को व्यर्थ करते हैं।

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

आप क्या देखते हैं इसका क्या अर्थ है क्या करें
क्लाइंट एक ब्राउज़र प्राधिकरण पृष्ठ खोलता है, या कहता है कि प्राधिकरण पृष्ठ मौजूद नहीं है। आपका क्लाइंट पुरानी 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 में कोड उदाहरण शामिल हैं।

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