Forritunaraðilar og AI samþætting

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

Gefðu gervigreindaraðstoðarmanninum þínum eða þínum eigin kóða beinan aðgang að yfir 130.000 viðmiðunarlitrófum, þekkingargrafa topprökhugsun og bókmenntastuddri túlkun. Veldu eina af þremur leiðum til að tengjast — MCP fyrir gervigreindaraðstoðarmenn, REST API fyrir kóða, eða tilbúna færni fyrir ókóðavettvanga. Sérhver leið hér að neðan hefur skref-fyrir-skref leiðbeiningar skrifaðar fyrir byrjendur.

Yfirfarið og skráð á

Áð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 stillir, þannig að endanotendur líma ekki persónulegan lykil. Að fá persónulegan lykil tekur um eina mínútu:

  1. Skráðu þig inn á FTIR.fun Búðu til ókeypis reikning ef þú ert ekki með. Nýir reikningar innihalda ókeypis prufueiningar.
  2. Opnaðu API lyklaborðið Farðu á Reikningur → API lyklar og smelltu á Generate.
  3. Afritaðu og vistaðu lykilinn strax Fulli lykillinn (hann byrjar á ftir_) er sýndur aðeins einu sinni. Geymdu hann á öruggum stað. Ef þú týnir honum, bara búa til nýjan.
🔑 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.
⚠️ Hýsta MCP þjónninn samþykkir aðeins reiknings API lykil sem myndaður er í FTIR.fun API lykla mælaborðinu (byrjar á ftir_). Þjónsíðu aðallyklar eru fyrir REST rekstraraðila og geta ekki skráð sig inn í hýstan MCP.

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

Allir þrír tengjast sömu vél: 130.000+ litróf, þekkingargrafsskynjun og tilvitnanir í ritrýni. Þú þarft aðeins einn. Veldu eftir því hvernig þú vinnur — ekki viss? MCP er vinsælasti kosturinn fyrir þá sem nota gervigreindaraðstoð.

Hvað gervigreindin þín getur raunverulega gert

Núverandi MCP, REST, n8n og LangChain útgáfur afhjúpa sjö aðgerðir. Útgefna Coze viðbótin afhjúpar þrjú tól (analyze, find, explain), og önnur sniðmát geta afhjúpað minna sett; skoðaðu hvert kort fyrir notkun. Aðgerðirnar hér að neðan deila sömu FTIR.fun þjónustu.

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.
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.

Studdar skrár: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. 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. Haltu upprunalegri skráarendingu svo FTIR.fun velji rétta þáttara.

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": "direct_read:spa",
     "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)

Hröð skimun (analyze_spectrum) skilar strax. Heildar þríáss skýrslan keyrir í bakgrunni og tekur venjulega 30–90 sekúndur. Ekki senda aftur á meðan skýrsla er í gangi — geymdu task_id og færðu fyrirspurn.

  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"}
  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_view (skipulagt skýrsluefni) 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.
⚠️ Ekki senda sömu skýrsluna aftur á meðan hún er í bið eða í gangi. Geymdu task_id og haltu áfram að færa fyrirspurn þar til hún er lokið eða mistókst. Tvíteknar innsendingar 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. Geymdu sama task_id og haltu áfram að polla. Ekki búa til afrit af skýrsluverkefnum.
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 beiðni Eyðublað