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

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

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

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

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

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

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

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

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

आपका AI वास्तव में क्या कर सकता है

वर्तमान MCP, REST, n8n और LangChain वितरण सात संचालन प्रकट करते हैं। प्रकाशित कोज़ प्लगइन तीन उपकरण (विश्लेषण, खोज, व्याख्या) प्रकट करता है, और अन्य टेम्पलेट छोटा घोषित सेट प्रकट कर सकते हैं; उपयोग से पहले प्रत्येक प्लेटफ़ॉर्म कार्ड की जाँच करें। नीचे दिए गए संचालन समान FTIR.fun सेवाएँ साझा करते हैं।

कार्य MCP उपकरण REST एंडपॉइंट अपने AI से यह कहें
एक उपकरण फ़ाइल पढ़ें parse_ftir_spectrum POST /parse-spectrum sample.spc को पार्स करें और पहचाने गए शिखरों की सूची बनाएँ।
अज्ञात स्पेक्ट्रम की पहचान करें 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 प्राप्त करें।

समर्थित फ़ाइलें: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON। मान्य sampling_mode मान हैं KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR और Others। Transmission एक मान्य मान नहीं है। मूल फ़ाइल एक्सटेंशन रखें ताकि FTIR.fun सही पार्सर चुन सके।

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": "direct_read:spa",
     "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"}
  2. मतदान जब तक completed true न हो जाए, हर 5–10 सेकंड में get_ftir_report_status (MCP) या GET /ftir/reports/{task_id} कॉल करें। पूर्ण प्रतिक्रिया में report_url, 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 को रखें और प्रतीक्षा करते रहें। डुप्लिकेट रिपोर्ट कार्य न बनाएं।
422 या missing_input अनुरोध बॉडी में आवश्यक फ़ील्ड गायब हैं या अमान्य प्रारूप है। analyze_spectrum के लिए, आपको कम से कम एक प्रदान करना होगा: peaks, query, या file_base64। जांचें कि आपका JSON मान्य है, Content-Type application/json है, और आवश्यक फ़ील्ड मौजूद हैं। ऊपर दिए गए उदाहरण अनुरोध देखें।
413 file_too_large अपलोड की गई स्पेक्ट्रम फ़ाइल आकार सीमा से अधिक है। एक छोटी फ़ाइल निर्यात करें या spectrum.peaks फ़ील्ड के माध्यम से केवल शिखर स्थानों का उपयोग करें।

निर्माण करने के लिए तैयार?

पूर्ण REST संदर्भ में प्रत्येक एंडपॉइंट, अनुरोध और प्रतिक्रिया प्रारूप, प्रमाणीकरण, दर सीमाएं, त्रुटि कोड, MCP टूल परिभाषाएं, और Python और curl में कोड उदाहरण शामिल हैं।

अनुरोध सबमिट करें फ़ॉर्म