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 130,000+ o sbectra cyfeirio, rhesymu copaon graff gwybodaeth, a dehongliad wedi'i gefnogi gan lenyddiaeth. Dewiswch un o dair ffordd i gysylltu — MCP ar gyfer cynorthwywyr AI, REST API ar gyfer cod, neu Sgil barod ar gyfer llwyfannau dim cod. Mae pob llwybr isod yn cynnwys cyfarwyddiadau cam-wrth-gam wedi'u hysgrifennu ar gyfer defnyddwyr tro cyntaf.

Adolygwyd a rhestru ar

Cyn i chi ddechrau — cael eich allwedd API

Mae MCP a'r REST API yn defnyddio un allwedd API FTIR.fun. Mae Coze/Doubao yn defnyddio allwedd gwasanaeth a ffurfweddwyd gan gyhoeddwr y plugin, felly nid yw defnyddwyr terfynol yn gludo allwedd bersonol. Mae cael allwedd bersonol yn cymryd tua munud:

  1. Mewngofnodi i FTIR.fun Crëwch gyfrif am ddim os nad oes gennych un. Mae cyfrifon newydd yn cynnwys credydau treial am ddim.
  2. Agorwch y dangosfwrdd Allweddi API Ewch i Cyfrif → Allweddau API a chliciwch Cynhyrchu.
  3. Copïwch ac arbedwch yr allwedd ar unwaith Mae'r allwedd lawn (yn dechrau gyda ftir_) yn cael ei dangos unwaith yn unig. Storiwch mewn lle diogel. Os byddwch yn ei cholli, cynhyrchwch un newydd.
🔑 Barod? Agorwch y Dangosfwrdd Allweddau API mewn tab newydd, yna dewch yn ôl a dilynwch y llwybr a ddewisoch uchod.
⚠️ Mae'r gweinydd MCP a gynhelir yn derbyn allwedd API cyfrif yn unig a gynhyrchir yn y Bwrdd Gwaith Allweddi API FTIR.fun (yn dechrau gyda ftir_). Mae allweddi meistr ochr gweinydd ar gyfer gweithredwyr REST ac ni allant fewngofnodi i MCP a gynhelir.

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

Mae'r tri yn cysylltu â'r un injan: 130,000+ sbectra, rhesymeg graff gwybodaeth, a dyfyniadau llenyddiaeth. Dim ond un sydd ei angen arnoch. Dewiswch yn ôl sut rydych yn gweithio — ddim yn siŵr? MCP yw'r dewis mwyaf poblogaidd i unrhyw un sy'n defnyddio cynorthwyydd AI.

Beth y gall eich AI ei wneud mewn gwirionedd

Mae'r dosbarthiadau MCP, REST, n8n, a LangChain cyfredol yn datgelu saith gweithrediad. Mae'r ategyn Coze a gyhoeddwyd yn datgelu tair offeryn (dadansoddi, dod o hyd i, esbonio), ac efallai y bydd templedi eraill yn datgelu set ddatganedig llai; gwiriwch bob cerdyn platfform cyn ei ddefnyddio. 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.
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.

Ffeiliau a gefnogir: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Gwerthoedd sampling_mode dilys yw Peled KBr, Anwedd, Toddydd, Ffilm Denau, Mull Paraffin, ATR, Adlewyrchiad Gwasgaredig, Micro IR, ac Eraill. Nid yw Trosglwyddiad yn werth dilys. Cadwch yr estyniad ffeil gwreiddiol fel bod FTIR.fun yn dewis y parser cywir.

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": "direct_read:spa",
     "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 tri-echel llawn yn rhedeg yn y cefndir ac fel arfer yn cymryd 30–90 eiliad. Peidiwch ag ailddanysod tra bod adroddiad yn rhedeg — cadwch y task_id a phleidleisiwch.

  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"}
  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 yn cynnwys report_url, report_view (cynnwys adroddiad strwythuredig), 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.
⚠️ Peidiwch â chyflwyno'r un adroddiad eto tra ei fod mewn ciw neu'n rhedeg. Cadwch y task_id a pharhau i bleidleisio nes iddo gwblhau neu fethu. Mae cyflwyniadau dyblyg 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 pharhewch i boli. Peidiwch â chreu adroddiadau dyblyg.
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 Cais Ffurflen