FTIR.fun FTIR.fun
Razvijalec in integracija AI

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

Dajte svojemu asistentu AI ali svoji kodi neposreden dostop do 130.000+ referenčnih spektrov, sklepanja na podlagi znanja o vrhovih in interpretacije, podprte z literaturo. Izberite enega od treh načinov povezovanja – MCP za asistenta AI, REST API za kodo ali že pripravljeno veščino za platforme brez kodiranja. Vsaka pot spodaj ima navodila po korakih, napisana za prve uporabnike.

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

Pred začetkom — pridobite svoj API ključ

MCP in REST API uporabljata en FTIR.fun API ključ. Coze/Doubao uporablja storitveni ključ, ki ga konfigurira založnik vtičnika, zato končni uporabniki ne prilepijo osebnega ključa. Pridobitev osebnega ključa traja približno minuto:

  1. Prijavite se v FTIR.fun Ustvarite brezplačen račun, če ga še nimate. Novi računi vključujejo brezplačne poskusne kredite.
  2. Odprite nadzorno ploščo API ključev Pojdite na Račun → API ključi in kliknite Generiraj.
  3. Takoj kopirajte in shranite ključ Celoten ključ (začne se s ftir_) je prikazan samo enkrat. Shranite ga na varno mesto. Če ga izgubite, preprosto ustvarite novega.
🔑 Pripravljen? Odprite nadzorno ploščo API ključev v novem zavihku, nato se vrnite in sledite poti, ki ste jo izbrali zgoraj.
⚠️ Gostovani strežnik MCP sprejema samo API ključ računa, ustvarjen v nadzorni plošči API ključev FTIR.fun (začne se s ftir_). Glavni ključi na strežniku so za operaterje REST in se ne morejo prijaviti v gostovani MCP.

Korak 1 – Katera povezava je prava za vas?

Vsi trije se povezujejo na isti pogon: 130.000+ spektrov, sklepanje z znanjem-grafom in literaturne navedbe. Potrebujete le enega. Izberite glede na to, kako delate — niste prepričani? MCP je najbolj priljubljena izbira za vse, ki uporabljajo AI pomočnika.

Kaj vaš AI dejansko zmore

Trenutne distribucije MCP, REST, n8n in LangChain izpostavljajo sedem operacij. Objavljeni vtičnik Coze izpostavlja tri orodja (analiziraj, najdi, razloži), druge predloge pa lahko izpostavijo manjši deklariran niz; pred uporabo preverite kartico vsake platforme. 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.
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.

Podprte datoteke: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Veljavne vrednosti sampling_mode so KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR in Others. Transmission ni veljavna vrednost. Ohranite prvotno končnico datoteke, da FTIR.fun izbere pravilen razčlenjevalnik.

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

Hitri pregled (analyze_spectrum) se vrne takoj. Celotno triosno poročilo deluje v ozadju in običajno traja 30–90 sekund. Ne pošiljajte ponovno, medtem ko poročilo teče — shranite task_id in ga poizvedujte.

  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"}
  2. Anketa Pokličite get_ftir_report_status (MCP) ali GET /ftir/reports/{task_id} vsakih 5–10 sekund, dokler completed ni true. Odziv dokončanja vključuje report_url, report_view (strukturirano vsebino poročila) 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.
⚠️ Ne oddajte ponovno istega poročila, medtem ko je v čakalni vrsti ali teče. Shranite task_id in ponovno poizvedujte, dokler ni dokončano ali ne uspe. Podvojene oddaje zapravljajo 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 nadaljujte s preverjanjem. Ne ustvarjajte podvojenih nalog poročil.
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