FTIR.fun FTIR.fun
Arendaja ja AI integratsioon

Ühendage FTIR.fun iga AI tööriista või rakendusega

Andke oma AI assistendile või oma koodile otsene juurdepääs enam kui 130 000-le referentsspektrile, teadmusgraafi tippude põhjendustele ja kirjandusest toetatud tõlgendusele. Valige üks kolmest ühendusviisist – MCP AI assistentidele, REST API koodile või valmis oskus ilma koodita platvormidele. Iga tee all on samm-sammult juhised, mis on kirjutatud esmakordsetele kasutajatele.

1. Valige oma tee 2. MCP seadistus 3. REST API 4. Oskused ja pluginad 5. Mida teie AI suudab teha 6. Veaotsing
Üle vaadatud ja loetletud

Enne alustamist hankige oma API võti

MCP ja REST API kasutavad mõlemad ühte FTIR.fun API võtit. Coze/Doubao kasutab plugina väljaandja konfigureeritud teenusevõtit, seega lõppkasutajad ei kleebi isiklikku võtit. Isikliku võtme hankimine võtab umbes minuti:

  1. Logige sisse FTIR.fun＇i Looge tasuta konto, kui teil seda pole. Uued kontod sisaldavad tasuta proovikrediiti.
  2. Avage API võtmete juhtpaneel Minge Konto → API võtmed ja klõpsake Genereeri.
  3. Kopeeri ja salvesta võti kohe Täielik võti (algab ftir_) kuvatakse ainult üks kord. Salvesta see turvalisse kohta. Kui kaotad selle, lihtsalt genereeri uus.
🔑 Valmis? Avage API võtmete juhtpaneel uuel vahekaardil, tulge seejärel tagasi ja järgige ülal valitud teed.
⚠️ Majutatud MCP-server aktsepteerib ainult FTIR.fun API võtmete armatuurlaual loodud konto API võtit (algab ftir_). Serveripoolsed meistrivõtmed on REST-operaatoritele ega saa majutatud MCP-sse sisse logida.

Samm 1 – milline ühendus sobib teile?

Kõik kolm ühenduvad sama mootoriga: 130 000+ spektrit, teadmiste graafipõhine arutlus ja kirjanduse viited. Teil on vaja ainult ühte. Valige vastavalt oma tööviisile — pole kindel? MCP on kõige populaarsem valik kõigile, kes kasutavad AI assistenti.

Mida teie AI tegelikult teha suudab

Praegused MCP, REST, n8n ja LangChain distributsioonid eksponeerivad seitse toimingut. Avaldatud Coze plugin eksponeerib kolm tööriista (analüüsi, leia, seleta) ja teised mallid võivad eksponeerida väiksema deklareeritud komplekti; kontrollige enne kasutamist iga platvormi kaarti. Allpool olevad toimingud jagavad samu FTIR.fun teenuseid.

Ülesanne MCP tööriist REST-i lõpp-punkt Ütle seda oma AI-le
Loe instrumendi faili parse_ftir_spectrum POST /parse-spectrum Parsige sample.spc ja loetlege tuvastatud piigid.
Tuvastage tundmatu spekter analyze_ftir_spectrum POST /ftir/analyze_spectrum Tuvasta, milline polümeer see spekter on.
Esita täielik kolmeteljeline aruanne submit_ftir_report POST /ftir/reports Esitage sample.spa täieliku aruande saamiseks ATR režiimis.
Küsitle ja hangi see aruanne. get_ftir_report_status GET /ftir/reports/{task_id} Kontrollige aruande ülesannet ja andke mulle link, kui see on valmis.
Selgita piike explain_peaks POST /ftir/explain_peak_assignments Mida näitavad tipud lainearvudel 1715 ja 1450 cm-1?
Leia teadaolev referentsspekter find_spectra POST /ftir/find_spectra Leia polüstüreeni võrdlusspektrid.
Ava uuesti varasem tulemus fetch_result GET /ftir/result/{result_num} Too tulemus 20260528100755416137536.

Toetatud failid: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Kehtivad proovivõtumeetodi väärtused on KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ja Others. Transmission ei ole kehtiv väärtus. Säilitage algne faililaiend, et FTIR.fun valiks õige parseri.

find_spectra vastuse näide

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

explain_peaks vastuse näide

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

Täieliku aruande saamine (asünkroonne)

Kiire sõeluuring (analyze_spectrum) tagastab kohe. Täielik teljetearuanne töötab taustal ja võtab tavaliselt 30–90 sekundit. Ära esita uuesti, kui aruanne töötab — säilita task_id ja polli seda.

  1. Esita Helistage submit_ftir_report (MCP) või POST /ftir/reports (REST). Saate tagasi task_id ja reserveeritud result_num. Väli file_base64 on nõutud; muud väljad (sampling_mode, prior_context, language_code, sample_name, sample_order_no) on valikulised.
    Esita näide (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"}'
    Esita vastus 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. Küsitlus Helista get_ftir_report_status (MCP) või GET /ftir/reports/{task_id} iga 5–10 sekundi järel, kuni completed on true. Lõpetatud vastus sisaldab report_url, report_view (struktureeritud aruande sisu) ja result_num.
    Pollimise näide 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Pollingu vastus (töös) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Polli vastus (lõpetatud) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Avage lõpparuanne Ava täis URL https://ftir.fun/outputdata/?num={result_num} brauseris, et vaadata FTIR.fun-i poolt renderdatud täielikku teljetulemuste lehte.
⚠️ Ära esita sama aruannet uuesti, kui see on järjekorras või töös. Säilita task_id ja jätka pollingut, kuni see on lõpetatud või ebaõnnestunud. Korduvad esitused raiskavad punkte.

Veatõrje

Mida näete Mida see tähendab Mida teha
Klient avab brauseri autoriseerimislehe või ütleb, et autoriseerimislehte pole olemas. Teie klient kasutab vana OAuth-stiilis serveri sissekannet. FTIR.fun ei kasuta OAuth＇i — ainult API võtit. Kustuta vana ftirfun serveri kirje, kleepi täpne konfiguratsioon sellelt lehelt, laadi klient uuesti ja käivita ftirfun uuesti.
401 (MCP) / 401 invalid_api_key (REST) API võti on puudu, aegunud, tühistatud või valesti kleepitud. Taaskäivitage server ja kleepige ainult toores võti (algab ftir_). Loo uus võti API võtmete armatuurlaud vajadusel.
Server käivitub, kuid tööriistu ei ilmu. Klient pole oma kataloogi värskendanud või konfiguratsioon kasutab vale võtme nime. VS Code＇i puhul kontrollige, et mcp.json kasutab servers (mitte mcpServers). Seejärel peatage ja käivitage ftirfun uuesti või laadige aken uuesti.
403 insufficient_balance Kontol pole selle analüüsi jaoks piisavalt punkte. Kontrolli oma saldot või tellimust FTIR.fun＇is ja proovi uuesti.
429 rate_limit_exceeded REST-i analüüs ja parsingu lubab 60 päringut minutis API võtme kohta; REST-i tulemuse ja aruande oleku lugemised kasutavad eraldi 120 päringut minutis ＂bucketit＂; MCP lubab 60 kõnet minutis iga API võtme ja tööriista kohta. Oodake tööriista teatatud uuesti proovimise perioodi enne uuesti kutsumist.
Aruanne jääb järjekorda või töötab. Täielikud aruanded töötavad asünkroonselt ja võtavad kauem aega kui kiire sõelumine. Hoia sama task_id ja jätka pärimist. Ära loo dubleerivaid aruandetöid.
422 või missing_input Päringu kehas puuduvad nõutud väljad või on see vigases formaadis. analyze_spectrum jaoks peate esitama vähemalt ühe järgnevatest: peaks, query või file_base64. Kontrollige, et teie JSON on korrektne, Content-Type on application/json ja nõutud väljad on olemas. Vaadake ülaltoodud näitepäringuid.
413 file_too_large Üleslaaditud spektrifail ületab suuruspiirangut. Ekspordi väiksem fail või kasuta ainult piikide asukohti spektri.peaks välja kaudu.

Valmis ehitama?

Täielik REST viide sisaldab kõiki lõpp-punkte, päringu- ja vastusevorminguid, autentimist, kiiruspiiranguid, veakoode, MCP tööriistade määratlusi ja koodinäiteid Pythonis ja curlis.

Esita taotlus Vorm