FTIR.funFTIR.fun
Kūrėjo ir DI integracija

Prijunkite FTIR.fun prie bet kokio AI įrankio ar programos

Suteikite savo DI asistentui arba kodui tiesioginę prieigą prie 320,000+ etaloninių spektrų, žinių grafu pagrįsto smailių aiškinimo ir literatūra pagrįstos interpretacijos. Pasirinkite vieną iš trijų prisijungimo būdų — MCP DI asistentams, REST API kodui arba paruoštą Skill sprendimą platformoms be kodo. Toliau pateikiami nuoseklūs nurodymai, parengti pirmą kartą naudojantiems vartotojams.

1. Pasirinkite savo kelią 2. MCP sąranka 3. REST API 4. Įgūdžiai ir papildiniai 5. Ką gali jūsų AI 6. Trikčių šalinimas
Paskelbta

Prieš pradėdami – gaukite savo API raktą

Tiek MCP, tiek REST API naudoja vieną FTIR.fun API raktą. „Coze“ / „Doubao“ naudoja paslaugos raktą, sukonfigūruotą įskiepio leidėjo, todėl galutiniai naudotojai gali naudotis įskiepiu neįklijuodami asmeninio rakto. Asmeniniam raktui gauti reikia maždaug minutės:

  1. Prisijunkite prie FTIR.fun Sukurkite nemokamą paskyrą (naujoms paskyroms suteikiami nemokami bandomieji kreditai).
  2. Atidarykite API raktų skydelį Eikite į Paskyra → API raktai ir spustelėkite Generuoti.
  3. Peržiūrėkite arba nukopijuokite savo API raktą Visas raktas (jis prasideda ftir_) lieka prieinamas API raktų skydelyje. Galite ten grįžti, kad jį peržiūrėtumėte, nukopijuotumėte arba panaikintumėte.
🔑 Pasiruošę? Atidarykite API raktų skydelį naujame skirtuke, tada grįžkite ir eikite pasirinktu keliu aukščiau.

1 žingsnis – Kuris ryšys jums tinka?

Visi trys prisijungia prie to paties modulio: 320,000+ spektrų, žinių grafų samprotavimo ir literatūros citatų. Jums reikia tik vieno. Pasirinkite jūsų darbo būdą atitinkantį kelią; MCP yra patogus pasirinkimas dirbantiems su DI asistentais.

Ką jūsų DI iš tikrųjų gali padaryti

Suvienodintos MCP ir REST paslaugos pateikia tą patį FTIR.fun operacijų katalogą. API raktams gali būti suteikta mažesnė galimybių apimtis, o konkrečiai platformai skirti aprašai gali sąmoningai skelbti tik poaibį. Toliau pateiktos operacijos naudoja tas pačias FTIR.fun paslaugas.

Užduotis MCP įrankis REST galinis taškas Pasakykite tai savo DI
Skaityti prietaiso failą parse_ftir_spectrum POST /parse-spectrum Išanalizuokite sample.spc ir išvardinkite aptiktas smailes.
Konvertuoti savojo formato duomenis ir išsaugoti metaduomenis convert_native_spectrum POST /native-spectrum/convert Konvertuoti sample.spa į JDX ir išsaugoti šaltinio meta duomenis.
Identifikuoti nežinomą spektrą analyze_ftir_spectrum POST /ftir/analyze_spectrum Atpažinkite, koks tai polimeras pagal šį spektrą.
Pateikite visą triašę ataskaitą submit_ftir_report POST /ftir/reports Pateikite sample.spa, kad gautumėte visą ataskaitą ATR režimu.
Apklauskite ir gaukite tą ataskaitą get_ftir_report_status GET /ftir/reports/{task_id} Patikrinkite ataskaitos užduotį ir pateikite man nuorodą, kai ji bus baigta.
Paaiškinti smailes explain_peaks POST /ftir/explain_peak_assignments Ką rodo smailės ties 1715 ir 1450 cm-1?
Raskite žinomą atskaitos spektrą find_spectra POST /ftir/find_spectra Raskite polistirolo referencinius spektrus.
Atidarykite ankstesnį rezultatą fetch_result GET /ftir/result/{result_num} Gaukite rezultatą 20260528100755416137536.
🎓 Akademinis smailių priskyrimas — Mėginiams, kurių sudėtis žinoma, pažangi FTIR.fun REST/MCP funkcija priskiria kiekvieną išmatuotą smailę, pateikdama literatūroje atsekamus įrodymus. Kiekvienas pateikimas kainuoja 30 taškų arba yra nemokamas naudojant aktyvią prenumeratą; būsenos užklausos neapmokestinamos. Apibūdinkite užduotį natūraliai (pavyzdžiui: „Priskirkite visus išmatuotus FTIR smailes šiam spektrui; mėginys yra žinomas PMMA; atsiųskite ataskaitą el. paštu man“) – klientas pateikia failą, o jums niekada nereikia patiems kurti JSON ar Base64. Užbaigti rezultatai grąžina tiek JSON būseną, tiek apsaugotus ataskaitų adresus; ataskaitos nėra viešai pasiekiamos atsisiuntimo nuoroda.

Palaikomi spektro failų plėtiniai (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. Išlaikykite originalų failo plėtinį. Nepalaikomi arba neįskaitomi failai grąžina supported_extensions ir supported_formats. Galiojančios sampling_mode reikšmės: KBr granulė, Garai, Tirpiklis, Plona plėvelė, Parafino suspensija, ATR, Difuzinis atspindys, Mikro IR ir Kiti. Transmisija nėra galiojanti reikšmė.

find_spectra atsakymo pavyzdys

find_spectra atsakymas 
{
  "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 atsakymo pavyzdys

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

Gaunama visa ataskaita (asinchroniškai)

Greitoji patikra (analyze_spectrum) pateikia rezultatą iš karto. Visa trijų ašių ataskaita vykdoma fone ir paprastai užtrunka 30–90 sekundžių. Išsaugokite task_id ir tikrinkite jo būseną, o ne pateikite užklausą iš naujo.

  1. Pateikti Iškvieskite submit_ftir_report (MCP) arba POST /ftir/reports (REST). Jūs gaunate task_id ir rezervuotą result_num. Laukas file_base64 yra privalomas; kiti laukai (sampling_mode, prior_context, language_code, sample_name, sample_order_no) yra pasirenkami.
    Pateikimo pavyzdys (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"}'
    Pateikti atsakymą 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Apklausa Kvieskite get_ftir_report_status (MCP) arba GET /ftir/reports/{task_id} kas 5–10 sekundžių, kol completed bus true. Užbaigtas atsakymas apima report_url, report objektą (struktūrizuoto rezultato turinį, kuriame yra išsamus report_view) ir result_num.
    Teiravimosi pavyzdys 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Teiravimosi atsakymas (vykdoma) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Apklausos atsakymas (užbaigtas) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Atidarykite galutinę ataskaitą Atidarykite pilną URL https://ftir.fun/outputdata/?num={result_num} naršyklėje, kad pamatytumėte visą trijų ašių rezultatų puslapį, sugeneruotą FTIR.fun.
⚠️ Išsaugokite task_id ir periodiškai tikrinkite būseną, kol procesas bus baigtas arba nepavyks. Pasikartojantys pateikimai, kai užduotis yra eilėje arba vykdoma, eikvoja taškus.

Trikties šalinimas

Ką matote Ką tai reiškia Ką daryti
Klientas atidaro naršyklės autorizacijos puslapį arba sako, kad autorizacijos puslapis neegzistuoja. Jūsų klientas naudoja seną OAuth stiliaus serverio įrašą. FTIR.fun nenaudoja OAuth — tik API raktą. Ištrinkite seną ftirfun serverio įrašą, įklijuokite tikslią konfigūraciją iš šio puslapio, perkraukite klientą ir vėl paleiskite ftirfun.
401 (MCP) / 401 invalid_api_key (REST) API raktas trūksta, pasibaigė, panaikintas arba įklijuotas neteisingai. Paleiskite serverį iš naujo ir įklijuokite tik neapdorotą raktą (prasideda ftir_). Sugeneruokite naują raktą iš API raktų skydelis jei reikia.
Serveris paleidžiamas, bet įrankiai nepasirodo. Klientas neatnaujino savo katalogo arba konfigūracijoje naudojamas neteisingas rakto pavadinimas. VS Code, patvirtinkite, kad mcp.json naudoja servers (ne mcpServers). Tada sustabdykite ir paleiskite ftirfun arba iš naujo įkelkite langą.
403 insufficient_balance Paskyra neturi pakankamai taškų šiai analizei. Patikrinkite savo balansą arba prenumeratą FTIR.fun, tada bandykite dar kartą.
429 rate_limit_exceeded REST analizė ir apdorojimas leidžia 60 užklausų per minutę vienam API raktui; REST rezultatų ir ataskaitų būsenos skaitymai naudoja atskirą 120 užklausų per minutę kibirą; MCP leidžia 60 iškvietimų per minutę kiekvienam API raktui ir įrankiui. Palaukite įrankio nurodyto pakartotinio bandymo laikotarpio prieš vėl kviesdami.
Ataskaita lieka eilėje arba vykdoma. Visiški ataskaitos vykdomi asinchroniškai ir užtrunka ilgiau nei greita patikra. Išlaikykite tą patį task_id ir vykdykite apklausą. Jei praradote task_id, iškvieskite GET /ftir/tasks, kad išvardytumėte savo naujausias užduotis ir vėl jį rastumėte.
422 arba missing_input Užklausos tekste trūksta privalomų laukų arba jis yra netinkamo formato. Norėdami analizuoti spektrą, turite pateikti bent vieną iš: peaks, query arba file_base64. Patikrinkite, ar jūsų JSON yra teisingas, Content-Type yra application/json, ir privalomi laukai yra pateikti. Žr. pavyzdinius prašymus aukščiau.
413 file_too_large Įkeltas spektro failas viršija dydžio limitą. Eksportuokite mažesnį failą arba naudokite tik piko pozicijas per spectrum.peaks lauką.

Pasiruošę kurti?

Pilna REST nuoroda turi kiekvieną galinį tašką, užklausos ir atsakymo formatus, autentifikavimą, spartos apribojimus, klaidų kodus, MCP įrankių apibrėžimus ir kodo pavyzdžius Python bei curl.

Pateikti reikalavimą Forma