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

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

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

पुनरावलोकन केले & सूचीबद्ध केले

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

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

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

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

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

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

सध्याचे MCP, REST, n8n आणि LangChain वितरण सात ऑपरेशन्स उघड करतात. प्रकाशित Coze प्लगइन तीन साधने (analyze, find, explain) उघड करते, आणि इतर टेम्पलेट्स लहान घोषित संच उघड करू शकतात; वापर करण्यापूर्वी प्रत्येक प्लॅटफॉर्म कार्ड तपासा. खालील ऑपरेशन्स समान FTIR.fun सेवा सामायिक करतात.

कार्य MCP साधन REST endpoint तुमच्या 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 मध्ये कोड उदाहरणे आहेत.

विनंती सादर करा फॉर्म