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

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

Dodiet savam AI asistentam vai savam kodam tiešu piekļuvi vairāk nekā 130 000 references spektru, 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 prasmi platformām bez kodēšanas. Katram ceļam zemāk ir soli pa solim instrukcijas, kas rakstītas pirmreizējiem lietotājiem.

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
Pārskatīts un uzskaitīts

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

MCP un REST API abi izmanto vienu FTIR.fun API atslēgu. Coze/Doubao izmanto pakalpojuma atslēgu, ko konfigurējis spraudņa izdevējs, tāpēc galalietotāji neielīmē personīgo atslēgu. Personīgās atslēgas iegūšana aizņem apmēram minūti:

  1. Pierakstieties FTIR.fun Izveidojiet bezmaksas kontu, ja jums tāda nav. 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. Nokopējiet un saglabājiet atslēgu nekavējoties Pilnā atslēga (sākas ar ftir_) tiek parādīta tikai vienreiz. Uzglabājiet to drošā vietā. Ja to pazaudējat, vienkārši ģenerējiet jaunu.
🔑 Gatavs? Atveriet API atslēgu paneli jaunā cilnē, pēc tam atgriezieties un izpildiet iepriekš izvēlēto ceļu.
⚠️ Mitinātais MCP serveris pieņem tikai konta API atslēgu, kas ģenerēta FTIR.fun API atslēgu panelī (sākas ar ftir_). Servera puses galvenās atslēgas ir domātas REST operatoriem un nevar pietiekties mitinātajā MCP.

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

Visi trīs savienojas ar vienu un to pašu dzinēju: 130 000+ spektri, zināšanu grafu argumentācija un literatūras atsauces. Jums ir nepieciešams tikai viens. Izvēlieties pēc tā, kā strādājat — neesat pārliecināts? MCP ir populārākā izvēle ikvienam, kas izmanto AI asistentu.

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

Pašreizējās MCP, REST, n8n un LangChain izplatīšanas atklāj septiņas darbības. Publicētais Coze spraudnis atklāj trīs rīkus (analyze, find, explain), un citas veidnes var atklāt mazāku deklarēto kopu; pirms lietošanas pārbaudiet katras platformas karti. 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.
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.

Atbalstītie faili: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. 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. Saglabājiet sākotnējo faila paplašinājumu, lai FTIR.fun izvēlētos pareizo parsētāju.

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": "direct_read:spa",
     "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ā skrīnings (analyze_spectrum) atgriežas nekavējoties. Pilns trīsasu ziņojums darbojas fonā un parasti aizņem 30–90 sekundes. Neiesniedziet atkārtoti, kamēr ziņojums darbojas — saglabājiet task_id un pieprasiet to.

  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"}
  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_view (strukturēts ziņojuma saturs) 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.
⚠️ Neiesniedziet to pašu ziņojumu atkārtoti, kamēr tas ir rindā vai darbojas. Saglabājiet task_id un turpiniet pieprasīt, līdz tas ir pabeigts vai neizdevies. Dublēti iesniegumi izšķērd 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 turpiniet aptaujāt. Neveidojiet dublētus ziņojumu uzdevumus.
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 pieprasījumu Veidlapa