FTIR.funFTIR.fun
Arendaja ja AI integratsioon

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

Andke oma tehisintellekti assistendile või enda koodile otsejuurdepääs 320,000+ võrdlusspektrile, teadmusgraafikul põhinevale piigireasoning＇ule ja kirjandusel põhinevale tõlgendusele. Valige ühendamiseks üks kolmest võimalusest — MCP tehisintellekti assistentidele, REST API koodi jaoks või valmis Skill koodivabadele platvormidele. Kõik alltoodud võimalused sisaldavad samm-sammult juhiseid esmakasutajatele.

1. Valige oma tee 2. MCP seadistus 3. REST API 4. Oskused ja pluginad 5. Mida teie AI suudab teha 6. Veaotsing
Loetletud kuupäeval

Enne alustamist hankige oma API võti

MCP ja REST API kasutavad mõlemad ühte FTIR.fun API-võtit. Coze/Doubao kasutab plugina avaldaja konfigureeritud teenusevõtit, seega saavad lõppkasutajad pluginat kasutada ilma isiklikku võtit sisestamata. Isikliku võtme hankimine võtab umbes minuti:

  1. Logige sisse FTIR.fun＇i Loo tasuta konto (uued kontod sisaldavad tasuta proovikrediiti).
  2. Avage API võtmete juhtpaneel Minge Konto → API võtmed ja klõpsake Genereeri.
  3. Vaadake või kopeerige oma API-võti Täielik võti (algab ftir_) on endiselt saadaval API võtmete juhtpaneelil. Saate sinna naasta, et seda vaadata, kopeerida või tühistada.
🔑 Valmis? Avage API võtmete juhtpaneel uuel vahekaardil, tulge seejärel tagasi ja järgige ülal valitud teed.

Samm 1 – milline ühendus sobib teile?

Kõik kolm kasutavad sama mootorit: 320,000+ spektrit, teadmistegraafi-põhine arutlus ja kirjandusviited. Teil on vaja ainult ühte. Valige tööviisiga sobiv tee; MCP on tehisintellekti assistentide kasutajatele mugav valik.

Mida teie AI tegelikult teha suudab

Ühtsed MCP- ja REST-teenused avaldavad sama FTIR.fun-i toimingute kataloogi. API-võtmetele võidakse anda kitsam võimaluste ulatus, samas kui platvormispetsiifilised deklaratsioonid võivad tahtlikult avaldada ainult alamhulga. Allpool loetletud toimingud kasutavad samu FTIR.fun-i 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.
Konverteeri native andmed ja säilita metaandmed convert_native_spectrum POST /native-spectrum/convert Teisenda sample.spa JDX-iks ja säilita allikameetodi metaandmed.
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.
🎓 Akadeemiline piigi määramine — Teadaoleva koostisega proovide puhul määrab täiustatud FTIR.fun REST/MCP-võimekus igale mõõdetud piigile kirjandusel põhineva ja jälgitavate tõenditega määrangu. Iga esitamine maksab 30 punkti või on aktiivse tellimuse korral tasuta; olekupäringute eest tasu ei võeta. Kirjeldage ülesannet loomulikult (näiteks: „Määra kõik selle spektri mõõdetud FTIR-piigid; proov on teadaolevalt PMMA; saada aruanne mulle e-postiga“) — klient esitab faili ja te ei pea kunagi ise JSON-i ega Base64-d koostama. Lõpetatud tulemused tagastavad nii JSON-oleku kui ka kaitstud aruandeaadressid; aruanded ei ole avalikul allalaadimistee kättesaadavad.

Toetatud spektri failinime laiendid (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. Säilitage originaalne faililaiend. Toetamata või mitteloetavad failid tagastavad supported_extensions ja supported_formats. Kehtivad sampling_mode väärtused on KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ja Others. Transmission ei ole kehtiv väärtus.

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

Kiirsõelumine (analyze_spectrum) tagastab tulemuse kohe. Täielik kolme telje aruanne töötab taustal ja võtab tavaliselt 30–90 sekundit. Säilitage task_id ja küsitlege selle olekut, selle asemel et päringut uuesti esitada.

  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", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Küsitlus Kutsuge 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 objekti (struktureeritud tulemuste sisu, mille sees on detailne report_view) 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.
⚠️ Hoidke task_id alles ja küsitlege olekut, kuni toiming on lõppenud või ebaõnnestunud. Topeltesitused järjekorras või töötlemisel 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. Hoidke sama task_id väärtust ja küsitlege olekut. Kui kaotasite task_id väärtuse, kutsuge GET /ftir/tasks, et loetleda oma hiljutised ülesanded ja see uuesti leida.
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 nõue Vorm