FTIR.funFTIR.fun
Razvijalec in integracija AI

Povežite FTIR.fun s katerim koli orodjem ali aplikacijo AI

Svojemu pomočniku AI ali lastni kodi omogočite neposreden dostop do 320,000+ referenčnih spektrov, sklepanja o vrhovih na podlagi grafa znanja in interpretacije, podprte z literaturo. Izberite enega od treh načinov povezave — MCP za pomočnike AI, REST API za kodo ali že pripravljeno veščino za platforme brez kode. Vsaka od spodnjih poti vsebuje navodila po korakih, napisana za uporabnike, ki se s tem srečujejo prvič.

1. Izberite svojo pot 2. Nastavitev MCP 3. REST API 4. Spretnosti in vtičniki 5. Kaj zmore vaš AI 6. Odpravljanje težav
Navedeno dne

Pred začetkom — pridobite svoj API ključ

MCP in API REST uporabljata isti ključ API FTIR.fun. Coze/Doubao uporablja servisni ključ, ki ga konfigurira izdajatelj vtičnika, zato končni uporabniki uporabljajo vtičnik, ne da bi vnašali osebni ključ. Pridobitev osebnega ključa traja približno minuto:

  1. Prijavite se v FTIR.fun Ustvarite brezplačen račun (novi računi vključujejo dobroimetje za brezplačno preizkusno obdobje).
  2. Odprite nadzorno ploščo API ključev Pojdite na Račun → API ključi in kliknite Generiraj.
  3. Ogled ali kopiranje API ključa Celoten ključ (začne se z ftir_) ostane na voljo na nadzorni plošči API ključev. Tja se lahko vrnete, da si ga ogledate, kopirate ali prekličete.
🔑 Pripravljen? Odprite nadzorno ploščo API ključev v novem zavihku, nato se vrnite in sledite poti, ki ste jo izbrali zgoraj.

Korak 1 – Katera povezava je prava za vas?

Vsi trije se povezujejo z istim mehanizmom: 320,000+ spektrov, sklepanje na podlagi grafa znanja in navedbe iz literature. Potrebujete le enega. Izberite pot, ki ustreza vašemu načinu dela; MCP je priročna možnost za uporabnike pomočnikov z umetno inteligenco.

Kaj vaš AI dejansko zmore

Poenotene storitve MCP in REST izpostavljajo isti katalog operacij FTIR.fun. Ključi API lahko prejmejo manjši obseg zmogljivosti, medtem ko lahko platformno specifične deklaracije namerno objavijo le podmnožico. Spodnje operacije uporabljajo iste storitve FTIR.fun.

Naloga Orodje MCP REST končna točka Povejte to svoji umetni inteligenci
Preberite datoteko instrumenta parse_ftir_spectrum POST /parse-spectrum Razčleni sample.spc in naštej zazname vrhove.
Pretvori domače podatke in ohrani metapodatke convert_native_spectrum POST /native-spectrum/convert Pretvori sample.spa v JDX in ohrani izvorne metapodatke.
Identificirajte neznani spekter analyze_ftir_spectrum POST /ftir/analyze_spectrum Določite, kateri polimer je ta spekter.
Pošljite celotno triosno poročilo submit_ftir_report POST /ftir/reports Pošljite sample.spa za celotno poročilo v načinu ATR.
Preveri in pridobi to poročilo get_ftir_report_status GET /ftir/reports/{task_id} Preverite nalogo poročila in mi pošljite povezavo, ko je končana.
Pojasnite vrhove explain_peaks POST /ftir/explain_peak_assignments Kaj nakazujejo vrhovi pri 1715 in 1450 cm-1?
Poiščite znan referenčni spekter find_spectra POST /ftir/find_spectra Poiščite referenčne spektre za polistiren.
Ponovno odpri prejšnji rezultat fetch_result GET /ftir/result/{result_num} Pridobite rezultat 20260528100755416137536.
🎓 Akademska dodelitev vrhov — Pri vzorcih z znano sestavo napredna zmogljivost FTIR.fun REST/MCP vsakemu izmerjenemu vrhu dodeli literaturno podprte in sledljive dokaze. Vsaka predložitev stane 30 točk oziroma je brezplačna z aktivno naročnino; poizvedbe o stanju niso zaračunane. Nalogo opišite naravno (na primer: „Dodeli vse izmerjene FTIR vrhove za ta spekter; vzorec je znani PMMA; pošlji mi poročilo po e-pošti“) — odjemalec priskrbi datoteko in nikoli vam ni treba sami sestavljati JSON ali Base64. Zaključeni rezultati vrnejo tako status JSON kot zaščitene naslove poročil; poročila niso izpostavljena na javni poti za prenos.

Podprte končnice imen spektralnih datotek (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. Ohranite prvotno končnico datoteke. Nepodprte ali neberljive datoteke vrnejo supported_extensions in supported_formats. Veljavne vrednosti sampling_mode so KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR in Others. Transmission ni veljavna vrednost.

primer odziva find_spectra

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

primer odziva explain_peaks

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

Pridobivanje celotnega poročila (asinhrono)

Hitro presejanje (analyze_spectrum) se vrne takoj. Celotno poročilo s tremi osmi se izvaja v ozadju in običajno traja 30–90 sekund. Shranite task_id in ga preverjajte, namesto da zahtevo pošljete znova.

  1. Pošlji Pokličite submit_ftir_report (MCP) ali POST /ftir/reports (REST). Dobite nazaj task_id in rezerviran result_num. Polje file_base64 je obvezno; druga polja (sampling_mode, prior_context, language_code, sample_name, sample_order_no) so neobvezna.
    Primer oddaje (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"}'
    Oddaj odgovor 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Anketa Pokličite get_ftir_report_status (MCP) ali GET /ftir/reports/{task_id} vsakih 5-10 sekund, dokler completed ne postane true. Odgovor ob zaključku vključuje report_url, objekt report (strukturirano vsebino rezultatov s podrobnim report_view v njem) in result_num.
    Primer poizvedovanja 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Odziv poizvedovanja (v teku) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Odgovor na anketo (končano) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Odprite končno poročilo Odprite celoten URL https://ftir.fun/outputdata/?num={result_num} v brskalniku, da si ogledate celotno triosno stran z rezultati, ki jo prikaže FTIR.fun.
⚠️ Ohranite task_id in ga preverjajte, dokler ni dokončan ali neuspešen. Podvojene oddaje med čakanjem v vrsti ali izvajanjem porabljajo točke.

Odpravljanje težav

Kar vidite Kaj to pomeni Kaj storiti
Odjemalec odpre stran za avtorizacijo v brskalniku ali pa sporoči, da stran za avtorizacijo ne obstaja. Vaš odjemalec uporablja star vnos strežnika tipa OAuth. FTIR.fun ne uporablja OAuth — samo API ključ. Izbrišite stari vnos strežnika ftirfun, prilepite natančno konfiguracijo s te strani, znova naložite odjemalca in znova zaženite ftirfun.
401 (MCP) / 401 invalid_api_key (REST) API ključ manjka, je potekel, preklican ali nepravilno prilepljen. Znova zaženite strežnik in prilepite samo surov ključ (začne se z ftir_). Ustvarite nov ključ iz Nadzorna plošča API ključev Če je potrebno.
Strežnik se zažene, vendar se orodja ne prikažejo. Odjemalec ni osvežil svojega kataloga ali pa konfiguracija uporablja napačno ime ključa. Za VS Code potrdite, da mcp.json uporablja servers (ne mcpServers). Nato ustavite in znova zaženite ftirfun ali znova naložite okno.
403 insufficient_balance Račun nima dovolj točk za to analizo. Preverite svoje stanje ali naročnino v FTIR.fun, nato poskusite znova.
429 rate_limit_exceeded Analiza in razčlenjevanje REST omogočata 60 zahtev na minuto na ključ API; branja rezultatov in stanja poročil REST uporabljajo ločeno vedro 120 zahtev na minuto; MCP omogoča 60 klicev na minuto za vsak ključ API in orodje. Počakajte na obdobje ponovnega poskusa, ki ga sporoči orodje, preden ponovno kličete.
Poročilo ostane v čakalni vrsti ali teče. Celotna poročila se izvajajo asinhrono in trajajo dlje kot hitro presejanje. Ohranite isti task_id in izvajajte poizvedbe. Če ste izgubili task_id, pokličite GET /ftir/tasks, da prikažete nedavna opravila in ga znova poiščete.
422 ali missing_input Telo zahteve nima obveznih polj ali ima neveljaven format. Za analyze_spectrum morate zagotoviti vsaj enega od: peaks, query ali file_base64. Preverite, da je vaš JSON veljaven, Content-Type je application/json in da so obvezna polja prisotna. Oglejte si zgornje primere zahtev.
413 file_too_large Naložena spektralna datoteka presega omejitev velikosti. Izvozi manjšo datoteko ali uporabite samo položaje vrhov prek polja spectrum.peaks.

Pripravljeni za gradnjo?

Celotna REST referenca vsebuje vsako končno točko, formate zahtev in odgovorov, avtentikacijo, omejitve hitrosti, kode napak, definicije orodij MCP in primere kode v Pythonu in curl.

Pošlji zahtevo Obrazec