డెవలపర్ & AI ఇంటిగ్రేషన్

FTIR.fun ను ఏ AI టూల్ లేదా యాప్‌కైనా కనెక్ట్ చేయండి

320,000+ రిఫరెన్స్ స్పెక్ట్రాలకు, నాలెడ్జ్-గ్రాఫ్ పీక్ రీజనింగ్‌కు, మరియు సాహిత్య ఆధారిత వివరణకు మీ AI సహాయకుడికి లేదా మీ స్వంత కోడ్‌కు నేరుగా ప్రాప్యత ఇవ్వండి. కనెక్ట్ కావడానికి మూడు మార్గాల్లో ఒకదాన్ని ఎంచుకోండి — AI సహాయకుల కోసం MCP, కోడ్ కోసం REST API, లేదా నో-కోడ్ ప్లాట్‌ఫారమ్‌ల కోసం సిద్ధంగా ఉన్న Skill. దిగువ ప్రతి మార్గానికి మొదటిసారి ఉపయోగించే వినియోగదారుల కోసం దశలవారీ సూచనలు ఉన్నాయి.

జాబితా చేసిన తేదీ

మీరు ప్రారంభించడానికి ముందు — మీ API కీని పొందండి

MCP మరియు REST API రెండూ ఒకే FTIR.fun API కీని ఉపయోగిస్తాయి. Coze/Doubao ప్లగిన్ ప్రచురణకర్త కాన్ఫిగర్ చేసిన సర్వీస్ కీని ఉపయోగిస్తుంది, కాబట్టి తుది వినియోగదారులు వ్యక్తిగత కీని పేస్ట్ చేయకుండా ప్లగిన్ ద్వారా పనిచేస్తారు. వ్యక్తిగత కీ పొందడానికి సుమారు ఒక నిమిషం పడుతుంది:

  1. FTIR.fun లో సైన్ ఇన్ చేయండి ఉచిత ఖాతాను సృష్టించండి (కొత్త ఖాతాల్లో ఉచిత ట్రయల్ క్రెడిట్‌లు ఉంటాయి).
  2. API కీల డ్యాష్బోర్డ్ను తెరవండి వెళ్ళండి ఖాతా → API కీలు మరియు Generate క్లిక్ చేయండి.
  3. మీ API కీని వీక్షించండి లేదా కాపీ చేయండి పూర్తి కీ (ఇది ftir_ తో ప్రారంభమవుతుంది) API కీల డాష్‌బోర్డ్‌లో అందుబాటులో ఉంటుంది. మీరు దానిని వీక్షించడానికి, కాపీ చేయడానికి లేదా రద్దు చేయడానికి అక్కడికి తిరిగి వెళ్లవచ్చు.
🔑 సిద్ధంగా ఉన్నారా? 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 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) వెంటనే ఫలితాన్ని అందిస్తుంది. పూర్తి త్రి-అక్ష నివేదిక బ్యాక్‌గ్రౌండ్‌లో నడుస్తుంది మరియు సాధారణంగా 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. పోల్ completed true అయ్యే వరకు ప్రతి 5–10 సెకన్లకు get_ftir_report_status (MCP) లేదా GET /ftir/reports/{task_id} ని పిలవండి. పూర్తయిన ప్రతిస్పందనలో 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 సర్వర్లను ఉపయోగిస్తుందని నిర్ధారించుకోండి (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 లలో కోడ్ ఉదాహరణలు ఉన్నాయి.

అవసరాన్ని సమర్పించండి ఫారం