FTIR.funFTIR.fun
Izstrādātājs un AI integrācija

Savienojiet FTIR.fun ar jebkuru AI rīku vai lietotni

Nodrošiniet savam AI asistentam vai paša kodam tiešu piekļuvi 320,000+ atsauces spektriem, zināšanu grafa pīķu analīzei un literatūrā pamatotai interpretācijai. Izvēlieties vienu no trim savienojuma veidiem — MCP AI asistentiem, REST API kodam vai gatavu Skill risinājumu platformām bez kodēšanas. Tālāk sniegtas soli pa solim instrukcijas, kas sagatavotas lietotājiem bez iepriekšējas pieredzes.

1. Izvēlieties savu ceļu 2. MCP iestatīšana 3. REST API 4. Prasmes un spraudņi 5. Ko jūsu AI var darīt 6. Problēmu novēršana
Norādīts

Pirms sākat — iegūstiet savu API atslēgu

Gan MCP, gan REST API izmanto vienu FTIR.fun API atslēgu. Coze/Doubao izmanto pakalpojuma atslēgu, ko konfigurē spraudņa publicētājs, tāpēc galalietotāji strādā, izmantojot spraudni, neievadot personīgo atslēgu. Personīgās atslēgas iegūšana aizņem aptuveni minūti:

  1. Pierakstieties FTIR.fun Izveidojiet bezmaksas kontu (jaunie konti ietver bezmaksas izmēģinājuma kredītus).
  2. Atveriet API atslēgu paneli Dodieties uz Konts → API atslēgas un noklikšķiniet uz Ģenerēt.
  3. Skatīt vai kopēt savu API atslēgu Pilnā atslēga (tā sākas ar ftir_) joprojām ir pieejama API atslēgu panelī. Jūs varat tur atgriezties, lai to skatītu, kopētu vai atsauktu.
🔑 Gatavs? Atveriet API atslēgu paneli jaunā cilnē, pēc tam atgriezieties un izpildiet iepriekš izvēlēto ceļu.

1. solis — kurš savienojums jums ir piemērots?

Visi trīs savienojas ar vienu un to pašu dzinēju: 320,000+ spektriem, zināšanu grafika spriešanu un literatūras citātiem. Jums nepieciešams tikai viens. Izvēlieties ceļu, kas atbilst jūsu darba veidam; MCP ir ērta iespēja AI asistentu lietotājiem.

Ko jūsu AI patiešām var darīt

Vienotie MCP un REST pakalpojumi nodrošina piekļuvi vienam un tam pašam FTIR.fun darbību katalogam. API atslēgas var saņemt mazāku funkcionalitātes tvērumu, savukārt platformai specifiskas deklarācijas var apzināti publicēt tikai apakškopu. Tālāk norādītās darbības izmanto tos pašus FTIR.fun pakalpojumus.

Uzdevums MCP rīks REST galapunkts Sakiet to savam AI
Nolasīt instrumenta failu parse_ftir_spectrum POST /parse-spectrum Parsēt sample.spc un uzskaitīt atklātās pīķus.
Pārveidot vietējos datus un saglabāt metadatus convert_native_spectrum POST /native-spectrum/convert Konvertēt sample.spa uz JDX un saglabāt avota metadatus.
Identificējiet nezināmu spektru analyze_ftir_spectrum POST /ftir/analyze_spectrum Identificējiet, kāds polimērs ir šis spektrs.
Iesniedziet pilnu tri-asis ziņojumu submit_ftir_report POST /ftir/reports Iesniedziet sample.spa pilnam ziņojumam ATR režīmā.
Aptaujā un izgūsti šo atskaiti get_ftir_report_status GET /ftir/reports/{task_id} Pārbaudiet ziņojuma uzdevumu un, kad tas būs pabeigts, dodiet man saiti.
Izskaidrot pīķus explain_peaks POST /ftir/explain_peak_assignments Ko norāda maksimumi pie 1715 un 1450 cm-1?
Atrodiet zināmu atsauces spektru find_spectra POST /ftir/find_spectra Atrodiet atsauces spektrus polistirolam.
Atkārtoti atvērt agrāku rezultātu fetch_result GET /ftir/result/{result_num} Iegūt rezultātu 20260528100755416137536.
🎓 Akadēmiskais pīķu piešķīrums — Paraugiem ar zināmu sastāvu uzlabotā FTIR.fun REST/MCP funkcionalitāte piešķir katram izmērītajam pīķim literatūrā izsekojami pamatotus pierādījumus. Katrs iesniegums maksā 30 punktus vai ir bezmaksas ar aktīvu abonementu; statusa vaicājumi netiek iekasēti. Aprakstiet uzdevumu dabiskā veidā (piemēram: “Piešķiriet visus izmērītos FTIR pīķus šim spektram; paraugs ir zināms PMMA; nosūtiet man pārskatu pa e-pastu”) — klients piegādā failu, un jums nekad nav pašam jāveido JSON vai Base64. Pabeigtie rezultāti atgriež gan JSON statusu, gan aizsargātās pārskatu adreses; pārskati nav pieejami publiskā lejupielādes ceļā.

Atbalstītie spektra faila nosaukuma paplašinājumi (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. Saglabājiet sākotnējo faila nosaukuma paplašinājumu. Neatbalstīti vai nelasāmi faili atgriež supported_extensions un supported_formats. Derīgās sampling_mode vērtības ir KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR un Others. Transmission nav derīga vērtība.

find_spectra atbildes piemērs

find_spectra atbilde 
{
  "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 atbildes piemērs

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

Pilna ziņojuma iegūšana (asinhroni)

Ātrā pārbaude (analyze_spectrum) atgriež rezultātu nekavējoties. Pilnais trīsasu pārskats darbojas fonā un parasti aizņem 30–90 sekundes. Saglabājiet task_id un pārbaudiet tā statusu, nevis iesniedziet pieprasījumu atkārtoti.

  1. Iesniegt Izsauciet submit_ftir_report (MCP) vai POST /ftir/reports (REST). Jūs saņemat task_id un rezervētu result_num. Lauks file_base64 ir obligāts; citi lauki (sampling_mode, prior_context, language_code, sample_name, sample_order_no) nav obligāti.
    Iesniegšanas piemērs (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"}'
    Iesniegt atbildi 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...",
 "status": "queued", "status_url": "https://ftir.fun/ftir/reports/rpt_abc123..."}
  2. Aptauja Izsauciet get_ftir_report_status (MCP) vai GET /ftir/reports/{task_id} ik pēc 5–10 sekundēm, līdz completed ir true. Pabeigtā atbilde ietver report_url, report objektu (strukturētu rezultātu saturu ar detalizētu report_view tajā) un result_num.
    Pieprasījuma piemērs 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    Pieprasījuma atbilde (notiek) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    Poll atbilde (pabeigts) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. Atveriet galīgo ziņojumu Atveriet pilnu URL https://ftir.fun/outputdata/?num={result_num} pārlūkprogrammā, lai skatītu pilno triju asu rezultātu lapu, ko renderējis FTIR.fun.
⚠️ Saglabājiet task_id un periodiski pārbaudiet statusu, līdz uzdevums ir pabeigts vai neizdevies. Dublēti iesniegumi, kamēr uzdevums atrodas rindā vai tiek izpildīts, lieki patērē punktus.

Problēmu novēršana

Ko jūs redzat Ko tas nozīmē Ko darīt
Klients atver pārlūkprogrammas autorizācijas lapu vai saka, ka autorizācijas lapa neeksistē. Jūsu klients izmanto vecu OAuth stila servera ierakstu. FTIR.fun neizmanto OAuth — tikai API atslēgu. Izdzēsiet veco ftirfun servera ierakstu, ielīmējiet precīzu konfigurāciju no šīs lapas, pārlādējiet klientu un atkal palaidiet ftirfun.
401 (MCP) / 401 invalid_api_key (REST) API atslēga trūkst, ir beidzies tās derīguma termiņš, tā ir atsaukta vai ielīmēta nepareizi. Restartējiet serveri un ielīmējiet tikai neapstrādāto atslēgu (sākas ar ftir_). Ģenerējiet jaunu atslēgu no API atslēgu panelis ja nepieciešams.
Serveris startējas, bet rīki neparādās. Klients nav atjaunojis savu katalogu, vai konfigurācijā tiek izmantots nepareizs atslēgas nosaukums. Lai VS Code apstiprinātu, ka mcp.json izmanto serverus (nevis mcpServers). Pēc tam apturiet un palaidiet ftirfun vai pārlādējiet logu.
403 insufficient_balance Kontā nav pietiekami daudz punktu šai analīzei. Pārbaudiet savu bilanci vai abonementu FTIR.fun, pēc tam mēģiniet vēlreiz.
429 rate_limit_exceeded REST analīze un parsēšana atļauj 60 pieprasījumus minūtē uz vienu API atslēgu; REST rezultātu un atskaites statusa nolasījumi izmanto atsevišķu 120 pieprasījumu minūtē grozu; MCP atļauj 60 izsaukumus minūtē katrai API atslēgai un rīkam. Pirms atkārtotas izsaukšanas nogaidiet rīka norādīto atkārtošanas periodu.
Ziņojums paliek rindā vai notiek. Pilni ziņojumi darbojas asinhroni un aizņem vairāk laika nekā ātrais skrīnings. Saglabājiet to pašu task_id un veiciet aptauju. Ja task_id ir pazudis, izsauciet GET /ftir/tasks, lai uzskaitītu savus nesenos uzdevumus un atrastu to vēlreiz.
422 vai missing_input Pieprasījuma pamattekstā trūkst nepieciešamo lauku vai ir nederīgs formāts. Lai analizētu spektru, jānorāda vismaz viens no: peaks, query vai file_base64. Pārbaudiet, vai jūsu JSON ir derīgs, Content-Type ir application/json, un ir norādīti obligātie lauki. Skatiet iepriekš minētos pieprasījumu piemērus.
413 file_too_large Augšupielādētais spektra fails pārsniedz izmēra ierobežojumu. Eksportējiet mazāku failu vai izmantojiet tikai pīķu pozīcijas, izmantojot spectrum.peaks lauku.

Gatavs būvēt?

Pilnajā REST atsaucē ir katrs galapunkts, pieprasījumu un atbilžu formāti, autentifikācija, ātruma ierobežojumi, kļūdu kodi, MCP rīku definīcijas un kodu piemēri Python un curl.

Iesniegt prasību Veidlapa