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

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

Suteikite savo AI asistentui arba savo kodui tiesioginę prieigą prie 130 000+ etaloninių spektrų, žinių grafo smailių argumentavimo ir literatūra pagrįsto interpretavimo. Pasirinkite vieną iš trijų prisijungimo būdų – MCP AI asistentams, REST API kodui arba paruoštą Skill įgūdį platformoms be kodo. Kiekviename žemiau pateiktame kelyje yra žingsnis po žingsnio instrukcijos, parašytos pirmą kartą naudotojams.

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
Peržiūrėta ir išvardyta

Prieš pradėdami – gaukite savo API raktą

MCP ir REST API naudoja vieną FTIR.fun API raktą. Coze/Doubao naudoja leidėjo sukonfigūruotą paslaugos raktą, todėl galutiniai vartotojai neįklijuoja asmeninio rakto. Asmeninio rakto gavimas užtrunka apie minutę:

  1. Prisijunkite prie FTIR.fun Sukurkite nemokamą paskyrą, jei jos neturite. Naujos paskyros apima nemokamus bandomuosius kreditus.
  2. Atidarykite API raktų skydelį Eikite į Paskyra → API raktai ir spustelėkite Generuoti.
  3. Nukopijuokite ir iš karto išsaugokite raktą Visas raktas (jis prasideda ftir_) rodomas tik vieną kartą. Laikykite jį saugioje vietoje. Jei jį pametate, tiesiog sugeneruokite naują.
🔑 Pasiruošę? Atidarykite API raktų skydelį naujame skirtuke, tada grįžkite ir eikite pasirinktu keliu aukščiau.
⚠️ Priimamas MCP serveris priima tik paskyros API raktą, sugeneruotą FTIR.fun API raktų skydelyje (prasideda ftir_). Serverio pusės pagrindiniai raktai yra skirti REST operatoriams ir negali prisijungti prie priimančio MCP.

1 žingsnis – Kuris ryšys jums tinka?

Visi trys jungiasi prie to paties variklio: 130 000+ spektrų, žinių grafiko samprotavimo ir literatūros citatų. Jums reikia tik vieno. Pasirinkite pagal tai, kaip dirbate — neaišku? MCP yra populiariausias pasirinkimas visiems, kurie naudoja AI asistentą.

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

Dabartinės MCP, REST, n8n ir LangChain distribucijos atskleidžia septynias operacijas. Paskelbtas Coze įskiepis atskleidžia tris įrankius (analyze, find, explain), o kiti šablonai gali atskleisti mažesnį deklaruotą rinkinį; prieš naudodami patikrinkite kiekvienos platformos kortelę. 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.
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.

Palaikomi failai: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Galiojančios sampling_mode reikšmės: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR ir Others. Transmission nėra galiojanti reikšmė. Išlaikykite originalų failo plėtinį, kad FTIR.fun pasirinktų teisingą analizatorių.

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

Greita patikra (analyze_spectrum) grąžinama iš karto. Visa trijų ašių ataskaita vykdoma fone ir paprastai trunka 30–90 sekundžių. Nepalikite naujos užklausos, kol ataskaita vykdoma – išsaugokite task_id ir teiraukitės.

  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"}
  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_view (struktūrizuotą ataskaitos turinį) 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.
⚠️ Nepateikite tos pačios ataskaitos dar kartą, kol ji yra eilėje arba vykdoma. Išsaugokite task_id ir toliau teiraukitės, kol ji bus baigta arba nepavyks. Dublikatai švaisto 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 toliau klauskite. Nekurkite dublikatų ataskaitų užduočių.
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 užklausą Forma