FTIR.funFTIR.fun
Forritunaraðilar og AI samþætting

Tengdu FTIR.fun við hvaða gervigreindartól eða forrit sem er

Veittu AI-aðstoðarmanni þínum eða eigin kóða beinan aðgang að 320,000+ viðmiðunarlitrófum, toppröksemdafærslu byggðri á þekkingargrafi og túlkun studdri fræðiritum. Veldu eina af þremur leiðum til tengingar — MCP fyrir AI-aðstoðarmenn, REST API fyrir kóða eða tilbúið Skill fyrir kerfi án kóðunar. Allar leiðirnar hér að neðan innihalda skref-fyrir-skref leiðbeiningar fyrir notendur í fyrsta sinn.

1. Veldu leiðina þína 2. MCP uppsetning 3. REST API 4. Færni og viðbætur 5. Hvað gervigreindin þín getur gert 6. Úrræðaleit
Skráð þann

Áður en þú byrjar — fáðu API lykilinn þinn

MCP og REST API nota bæði einn FTIR.fun API-lykil. Coze/Doubao notar þjónustulykil sem viðbótarútgefandinn hefur stillt, þannig að endanotendur geta unnið í gegnum viðbótina án þess að líma inn persónulegan lykil. Að fá persónulegan lykil tekur um það bil mínútu:

  1. Skráðu þig inn á FTIR.fun Búðu til ókeypis aðgang (nýir aðgangar innihalda ókeypis prufuinneign).
  2. Opnaðu API lyklaborðið Farðu á Reikningur → API lyklar og smelltu á Generate.
  3. Skoðaðu eða afritaðu API-lykilinn þinn. Allur lykillinn (hann byrjar á ftir_) er áfram tiltækur í API-lykla mælaborðinu. Þú getur farið þangað til að skoða, afrita eða afturkalla hann.
🔑 Tilbúinn? Opnaðu API lykla stjórnborðið í nýjum flipa, komdu svo aftur og fylgdu leiðinni sem þú valdir hér að ofan.

Skref 1 — Hvaða tenging hentar þér?

Öll þrjú tengjast sömu vélinni: 320,000+ litróf, rökhugsun með þekkingargrafi og tilvísanir í heimildir. Þú þarft aðeins eitt. Veldu þá leið sem hentar vinnulaginu þínu; MCP er þægilegur valkostur fyrir notendur gervigreindaraðstoðarmanna.

Hvað gervigreindin þín getur raunverulega gert

Sameinuðu MCP- og REST-þjónusturnar birta sama FTIR.fun-aðgerðaskrána. API-lyklar kunna að fá takmarkaðra heimildasvið, en vettvangssértækar yfirlýsingar geta vísvitandi birt aðeins hluta hennar. Aðgerðirnar hér að neðan deila sömu FTIR.fun-þjónustunum.

Verkefni MCP tól REST endapunktur Segðu þetta við AI-ið þitt
Lesa mælitækisskrá parse_ftir_spectrum POST /parse-spectrum Þátta sample.spc og listaðu greinda toppa.
Umbreyttu innheimtu gögnum og geymðu aðlaga convert_native_spectrum POST /native-spectrum/convert Umhverfanlegja sample.spa í JDX og halda upprunagagnagögnunum.
Bera kennsl á óþekkt litróf analyze_ftir_spectrum POST /ftir/analyze_spectrum Finndu hvaða fjölliða þetta litróf er.
Senda inn heila þriggja ása skýrslu submit_ftir_report POST /ftir/reports Sendu inn sample.spa fyrir fulla skýrslu í ATR-stillingu.
Skoða og sækja þá skýrslu get_ftir_report_status GET /ftir/reports/{task_id} Athugaðu skýrsluverkefnið og gefðu mér tengilinn þegar því er lokið.
Útskýra toppa explain_peaks POST /ftir/explain_peak_assignments Hvað gefa topparnir við 1715 og 1450 cm-1 til kynna?
Finndu þekkt viðmiðunarróf find_spectra POST /ftir/find_spectra Finna viðmiðunarspektra fyrir pólýstýren.
Opnaðu fyrri niðurstöðu aftur fetch_result GET /ftir/result/{result_num} Fáðu niðurstöðu 20260528100755416137536.
🎓 Fræðileg toppúthlutun — Fyrir sýni með þekkta samsetningu úthlutar háþróuð REST/MCP-geta FTIR.fun sérhverjum mældum toppi með sönnunargögnum sem rekja má til fræðilegra heimilda. Hver innsending kostar 30 punkta eða er ókeypis með virkri áskrift; stöðufyrirspurnir eru ekki gjaldfærðar. Lýstu verkefninu náttúrulega (til dæmis: “Úthlutaðu öllum mældum FTIR-toppum fyrir þetta litróf; sýnið er þekkt PMMA; sendu skýrsluna til mín með tölvupósti”) — biðlarinn lætur skrána í té og þú þarft aldrei að búa til JSON eða Base64 sjálfur. Lokið niðurstöður skila bæði JSON-stöðu og vernduðum skýrsluföngum; skýrslur eru ekki opnar á opinberri niðurhalslínu.

Studdar litrófsskráarendingar (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. Haltu upprunalegu skráarendingunni. Óstuddar eða ólæsilegar skrár skila supported_extensions og supported_formats. Gild sampling_mode gildi eru KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR og Others. Transmission er ekki gilt gildi.

dæmi um find_spectra svar

find_spectra svar 
{
  "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": [...]}
  ]
}

dæmi um explain_peaks svar

explain_peaks svar 
{
  "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..."
}

Að fá heildarskýrslu (ósamstillt)

Hraðskimun (analyze_spectrum) skilar niðurstöðu samstundis. Heildarskýrslan með þremur ásum keyrir í bakgrunni og tekur venjulega 30–90 sekúndur. Haltu task_id og kallaðu á stöðuna reglulega í stað þess að senda beiðnina aftur.

  1. Senda Kallaðu á submit_ftir_report (MCP) eða POST /ftir/reports (REST). Þú færð til baka task_id og frátekið result_num. file_base64 reiturinn er nauðsynlegur; aðrir reitir (sampling_mode, prior_context, language_code, sample_name, sample_order_no) eru valfrjálsir.
    Dæmi um innsendingu (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"}'
    Senda svar 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Könnun Kallaðu á get_ftir_report_status (MCP) eða GET /ftir/reports/{task_id} á 5–10 sekúndna fresti þar til completed er true. Lokið svar inniheldur report_url, report hlut (skipulagt niðurstöðuefni, með nákvæmu report_view inni í því) og result_num.
    Dæmi um fyrirspurn 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Fyrirspurnarsvar (í vinnslu) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Könnunarsvar (lokið) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Opnaðu lokaskýrsluna Opnaðu fulla slóðina https://ftir.fun/outputdata/?num={result_num} í vafra til að skoða heildar þríáss niðurstöðusíðuna sem FTIR.fun hefur gert.
⚠️ Haldið task_id og kannið stöðuna þar til ferlinu lýkur eða það mistekst. Tvíteknar innsendingar meðan verkefnið er í bið eða í keyrslu sóa punktum.

Úrræðaleit

Það sem þú sérð Hvað það þýðir Hvað á að gera
Viðskiptavinurinn opnar vafraheimildarsíðu, eða segir að heimildarsíðan sé ekki til. Biðlarinn þinn notar gamla OAuth-stíls þjónustufærslu. FTIR.fun notar ekki OAuth — aðeins API-lykil. Eyða gamla ftirfun-þjónninn, límdu nákvæma stillinguna af þessari síðu, endurhlaðaðu biðlaranum og ræstu ftirfun aftur.
401 (MCP) / 401 invalid_api_key (REST) API-lykill vantar, er útrunninn, afturkallaður eða límdur rangt. Endurræstu þjóninn og límdu bara hráan lykil (byrjar á ftir_). Búðu til nýjan lykil frá API lyklaborð ef þörf krefur.
Þjónninn ræsist en engin verkfæri birtast. Viðskiptavinurinn hefur ekki endurnýjað skráninguna sína, eða stillingin notar rangt lykilnafn. Fyrir VS Code, staðfestu að mcp.json noti servers (ekki mcpServers). Stöðvaðu síðan og endurræstu ftirfun, eða endurhlaðið gluggann.
403 insufficient_balance Reikningurinn hefur ekki næg stig fyrir þá greiningu. Athugaðu stöðu eða áskrift þína í FTIR.fun, reyndu síðan aftur.
429 rate_limit_exceeded REST greining og þáttun leyfa 60 beiðnir á mínútu á hvern API-lykil; REST niðurstöður og skýrslustöðu lestur nota sérstakan 120 beiðnir á mínútu hólf; MCP leyfir 60 köll á mínútu fyrir hvern API-lykil og tól. Bíddu eftir endurtökutímabilinu sem verkfærið tilkynnir áður en þú kallar aftur.
Skýrsla er í bið eða í keyrslu. Heildarskýrslur keyra ósamstillt og taka lengri tíma en hraðleitar. Haltu sama task_id og kallaðu á stöðuna reglulega. Ef þú hefur glatað task_id skaltu kalla á GET /ftir/tasks til að skrá nýleg verkefni og finna það aftur.
422 eða missing_input Beiðninni vantar nauðsynlega reiti eða hún er með ógilt snið. Fyrir analyze_spectrum verður þú að gefa að minnsta kosti eitt af: peaks, query, eða file_base64. Gakktu úr skugga um að JSON sé gilt, Content-Type sé application/json, og nauðsynlegir reitir séu til staðar. Sjá dæmi um beiðnir hér að ofan.
413 file_too_large Upphlaðna litrófsskráin fer yfir stærðartakmörk. Flyttu út minni skrá eða notaðu aðeins toppstöður í gegnum spectrum.peaks svæðið.

Tilbúinn að byggja?

Heildar REST tilvísunin hefur alla endapunkta, beiðni- og svörunarform, auðkenningu, hraðatakmarkanir, villukóða, MCP tóla skilgreiningar og kóðadæmi í Python og curl.

Senda inn beiðni Eyðublað