FTIR.funFTIR.fun
Integreiddio Datblygwr ac AI

Cysylltwch FTIR.fun ag unrhyw Offer neu Ap AI

Rhowch fynediad uniongyrchol i＇ch cynorthwyydd AI neu＇ch cod eich hun at 320,000+ sbectrwm cyfeirio, rhesymu brigiau graff gwybodaeth, a dehongliad wedi＇i ategu gan lenyddiaeth. Dewiswch un o dair ffordd i gysylltu — MCP ar gyfer cynorthwywyr AI, yr API REST ar gyfer cod, neu Skill parod ar gyfer llwyfannau heb god. Mae＇r cyfarwyddiadau cam wrth gam isod wedi＇u hysgrifennu ar gyfer defnyddwyr tro cyntaf.

1. Dewiswch eich llwybr 2. Gosod MCP 3. REST API 4. Sgiliau ac ategion 5. Beth all eich AI ei wneud 6. Datrys Problemau
Wedi＇i restru ar

Cyn i chi ddechrau — cael eich allwedd API

Mae MCP a’r API REST ill dau yn defnyddio un allwedd API FTIR.fun. Mae Coze/Doubao yn defnyddio allwedd gwasanaeth a ffurfweddwyd gan gyhoeddwr yr ategyn, felly mae defnyddwyr terfynol yn gweithio drwy’r ategyn heb gludo allwedd bersonol. Mae cael allwedd bersonol yn cymryd tua munud:

  1. Mewngofnodi i FTIR.fun Crëwch gyfrif am ddim (mae cyfrifon newydd yn cynnwys credydau treial am ddim).
  2. Agorwch y dangosfwrdd Allweddi API Ewch i Cyfrif → Allweddau API a chliciwch Cynhyrchu.
  3. Gweld neu gopïo eich allwedd API Mae＇r allwedd llawn (mae＇n dechrau gyda ftir_) yn aros ar gael yn nangosfwrdd API Keys. Gallwch ddychwelyd yno i＇w gweld, ei chopïo, neu ei ddirymu.
🔑 Barod? Agorwch y Dangosfwrdd Allweddau API mewn tab newydd, yna dewch yn ôl a dilynwch y llwybr a ddewisoch uchod.

Cam 1 — Pa gysylltiad sy＇n iawn i chi?

Mae＇r tri yn cysylltu â＇r un peiriant: 320,000+ sbectra, rhesymu graff gwybodaeth, a dyfyniadau llenyddiaeth. Dim ond un sydd ei angen arnoch. Dewiswch y llwybr sy＇n cyd-fynd â＇ch ffordd o weithio; mae MCP yn opsiwn cyfleus i ddefnyddwyr cynorthwywyr AI.

Beth y gall eich AI ei wneud mewn gwirionedd

Mae gwasanaethau MCP a REST unedig yn datgelu＇r un catalog gweithrediadau FTIR.fun. Gall allweddi API gael cwmpas galluoedd llai, tra gall datganiadau sy＇n benodol i＇r platfform gyhoeddi is-set yn fwriadol yn unig. Mae＇r gweithrediadau isod yn rhannu＇r un gwasanaethau FTIR.fun.

Tasg Teclyn MCP Pwynt terfyn REST Dywedwch hyn wrth eich AI
Darllen ffeil offeryn parse_ftir_spectrum POST /parse-spectrum Dadansoddi sample.spc a rhestru＇r copaon a ganfuwyd.
Trosi data brodorol a chadw metadata convert_native_spectrum POST /native-spectrum/convert Trosi sample.spa i JDX a chadw metadata ffynhonnell.
Adnabod sbectrwm anhysbys analyze_ftir_spectrum POST /ftir/analyze_spectrum Nodi pa bolymer yw＇r sbectrwm hwn.
Cyflwynwch adroddiad tri-echel llawn submit_ftir_report POST /ftir/reports Cyflwynwch sample.spa am adroddiad llawn yn y modd ATR.
Pleidleisiwch ac adferwch yr adroddiad hwnnw get_ftir_report_status GET /ftir/reports/{task_id} Gwiriwch y dasg adroddiad a rhowch y ddolen i mi pan fydd wedi＇i gwblhau.
Esbonio copaon explain_peaks POST /ftir/explain_peak_assignments Beth mae＇r copaon ar 1715 a 1450 cm-1 yn ei ddangos?
Dod o hyd i sbectrwm cyfeirnod hysbys find_spectra POST /ftir/find_spectra Canfod sbectra cyfeirio ar gyfer polystyren.
Ailagor canlyniad cynharach fetch_result GET /ftir/result/{result_num} Nôl canlyniad 20260528100755416137536.
🎓 Neilltuo Copa Academaidd — Ar gyfer samplau â chyfansoddiad hysbys, mae gallu REST/MCP uwch FTIR.fun yn aseinio pob copa a fesurir gyda thystiolaeth wedi＇i holrhain trwy lenyddiaeth. Mae pob cyflwyniad yn costio 30 pwynt, neu mae＇n rhad ac am ddim gyda thanysgrifiad gweithredol; ni chodir tâl am ymholiadau statws. Disgrifiwch y dasg yn naturiol (er enghraifft: “Neilltuwch holl frigau FTIR mesuredig ar gyfer y sbectrwm hwn; y sampl yw PMMA hysbys; anfonwch yr adroddiad i mi trwy e-bost”) — mae＇r cleient yn darparu＇r ffeil ac nid oes angen i chi adeiladu JSON na Base64 eich hun. Mae canlyniadau wedi＇u cwblhau＇n dychwelyd y statws JSON a chyfeiriadau adroddiad gwarchodedig; nid yw adroddiadau＇n cael eu datgelu ar lwybr lawrlwytho cyhoeddus.

Estyniadau enw ffeil sbectrwm a gefnogir (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. Cadwch estyniad yr enw ffeil gwreiddiol. Mae ffeiliau heb gefnogaeth neu na ellir eu darllen yn dychwelyd supported_extensions a supported_formats. Gwerthoedd sampling_mode dilys yw KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, ac Eraill. Nid yw Transmission yn werth dilys.

enghraifft ymateb find_spectra

ymateb 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": [...]}
  ]
}

enghraifft ymateb explain_peaks

Ymateb 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..."
}

Cael yr adroddiad llawn (anghydamserol)

Mae sgrinio cyflym (analyze_spectrum) yn dychwelyd ar unwaith. Mae＇r adroddiad tair echel llawn yn rhedeg yn y cefndir ac fel arfer yn cymryd 30–90 eiliad. Cadwch y task_id a holwch ef yn hytrach nag ailgyflwyno.

  1. Cyflwyno Galwch submit_ftir_report (MCP) neu POST /ftir/reports (REST). Byddwch yn cael task_id a result_num wrth gefn. Mae＇r maes file_base64 yn ofynnol; mae meysydd eraill (sampling_mode, prior_context, language_code, sample_name, sample_order_no) yn ddewisol.
    Cyflwyno enghraifft (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"}'
    Cyflwyno ymateb 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Pôl Galwch get_ftir_report_status (MCP) neu GET /ftir/reports/{task_id} bob 5–10 eiliad nes bod completed yn true. Mae＇r ymateb wedi＇i gwblhau＇n cynnwys report_url, gwrthrych report (cynnwys canlyniad strwythuredig, gyda＇r report_view manwl y tu mewn iddo), a result_num.
    Enghraifft pleidleisio 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Ymateb pleidleisio (ar y gweill) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Ymateb pôl (wedi＇i gwblhau) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Agorwch yr adroddiad terfynol Agorwch yr URL llawn https://ftir.fun/outputdata/?num={result_num} mewn porwr i weld tudalen ganlyniad tri-echel gyflawn a rendrir gan FTIR.fun.
⚠️ Cadwch y task_id a pholiwch nes iddo gwblhau neu fethu. Mae cyflwyniadau dyblyg tra bo＇r dasg mewn ciw neu＇n rhedeg yn gwastraffu pwyntiau.

Datrys Problemau

Yr hyn a welwch Beth mae＇n ei olygu Beth i＇w wneud
Mae＇r cleient yn agor tudalen awdurdodi porwr, neu＇n dweud nad yw＇r dudalen awdurdodi yn bodoli. Mae eich cleient yn defnyddio cofnod gweinydd hen-ffasiwn OAuth. Nid yw FTIR.fun yn defnyddio OAuth — dim ond allwedd API. Dilewch yr hen gofnod gweinydd ftirfun, gludwch y ffurfwedd union o＇r dudalen hon, ail-lwythwch y cleient, a dechreuwch ftirfun eto.
401 (MCP) / 401 invalid_api_key (REST) Mae＇r allwedd API ar goll, wedi dod i ben, wedi＇i dirymu, neu wedi＇i gludo＇n anghywir. Ailgychwynnwch y gweinydd a gludwch yr allwedd crai yn unig (yn dechrau gyda ftir_). Cynhyrchwch allwedd newydd o＇r Dangosfwrdd Allweddi API os oes angen.
Mae＇r gweinydd yn dechrau ond nid oes offer yn ymddangos. Nid yw＇r cleient wedi adnewyddu ei gatalog, neu mae＇r ffurfwedd yn defnyddio enw allwedd anghywir. Ar gyfer VS Code, cadarnhewch fod mcp.json yn defnyddio gweinyddion (nid mcpServers). Yna stopiwch a dechreuwch ftirfun, neu ail-lwythwch y ffenestr.
403 insufficient_balance Nid oes gan y cyfrif ddigon o bwyntiau ar gyfer y dadansoddiad hwnnw. Gwiriwch eich balans neu danysgrifiad yn FTIR.fun, yna rhowch gynnig arall arni.
429 rate_limit_exceeded Mae dadansoddi a pharsio REST yn caniatáu 60 o geisiadau y funud fesul allwedd API; mae darlleniadau canlyniad REST a statws-adrodd yn defnyddio bwced ar wahân o 120 cais y funud; mae MCP yn caniatáu 60 galwad y funud ar gyfer pob allwedd API ac offeryn. Arhoswch am y cyfnod aildrio a adroddir gan yr offeryn cyn galw eto.
Mae adroddiad yn aros mewn ciw neu＇n rhedeg. Mae adroddiadau llawn yn rhedeg yn anghydamserol ac yn cymryd mwy o amser na sgrinio cyflym. Cadwch yr un task_id a phleidleisiwch. Os ydych wedi colli＇r task_id, galwch GET /ftir/tasks i restru eich tasgau diweddar a dod o hyd iddo eto.
422 neu missing_input Mae＇r corff cais yn colli meysydd gofynnol neu mae ganddo fformat annilys. Ar gyfer analyze_spectrum, rhaid i chi ddarparu o leiaf un o＇r canlynol: peaks, query, neu file_base64. Gwiriwch fod eich JSON yn ddilys, Content-Type yn application/json, a bod meysydd gofynnol yn bresennol. Gweler yr enghreifftiau o geisiadau uchod.
413 file_too_large Mae＇r ffeil sbectrwm a uwchlwythwyd yn fwy na＇r terfyn maint. Allforiwch ffeil llai neu defnyddiwch safleoedd brig yn unig trwy＇r maes spectrum.peaks.

Yn barod i adeiladu?

Mae＇r cyfeirnod REST llawn yn cynnwys pob endpoint, fformatau cais ac ymateb, dilysu, terfynau cyfradd, codau gwall, diffiniadau offer MCP, ac enghreifftiau cod yn Python a curl.

Cyflwyno Gofyniad Ffurflen